快捷導(dǎo)航

vue3 + ElementPlus 封裝列表表格組件包含分頁(yè)

更新時(shí)間：2025年02月06日 09:37:04 作者：scorpion_V

文章介紹了如何在Vue3和ElementPlus中封裝一個(gè)包含分頁(yè)功能的通用列表表格組件,組件通過(guò)props接收表格數(shù)據(jù)、列配置、總條數(shù)、加載狀態(tài)和分頁(yè)配置,并通過(guò)events處理分頁(yè)和刷新事件,此外,還提供了自定義列內(nèi)容和操作按鈕的功能,感興趣的朋友跟隨小編一起看看吧

1. 組件設(shè)計(jì)

Props：

tableData：表格數(shù)據(jù)。
columns：表格列配置。
total：總條數(shù)。
loading：加載狀態(tài)。
pagination：分頁(yè)配置（當(dāng)前頁(yè)、每頁(yè)條數(shù)）。

Events：

update:pagination：分頁(yè)變化時(shí)觸發(fā)。
refresh：刷新數(shù)據(jù)時(shí)觸發(fā)。

Slots：

自定義列內(nèi)容。
自定義操作按鈕。

2. 封裝代碼

TableWithPagination.vue

<template>
  <div class="table-with-pagination">
    <!-- 表格 -->
    <el-table
      :data="tableData"
      border
      stripe
      v-loading="loading"
      style="width: 100%"
    >
      <!-- 動(dòng)態(tài)列 -->
      <el-table-column
        v-for="column in columns"
        :key="column.prop"
        :prop="column.prop"
        :label="column.label"
        :width="column.width"
        :align="column.align || 'center'"
      >
        <!-- 自定義列內(nèi)容 -->
        <template #default="scope" v-if="column.slot">
          <slot :name="column.slot" :row="scope.row"></slot>
        </template>
      </el-table-column>
      <!-- 操作列 -->
      <el-table-column
        v-if="$slots.actions"
        label="操作"
        align="center"
        :width="actionsWidth"
      >
        <template #default="scope">
          <slot name="actions" :row="scope.row"></slot>
        </template>
      </el-table-column>
    </el-table>
    <!-- 分頁(yè) -->
    <el-pagination
      class="pagination"
      background
      layout="total, sizes, prev, pager, next, jumper"
      :total="total"
      :page-size="pagination.pageSize"
      :current-page="pagination.pageNo"
      @size-change="handleSizeChange"
      @current-change="handleCurrentChange"
    />
  </div>
</template>
<script setup>
import { ref, watch } from 'vue';
const props = defineProps({
  tableData: {
    type: Array,
    default: () => [],
  },
  columns: {
    type: Array,
    default: () => [],
  },
  total: {
    type: Number,
    default: 0,
  },
  loading: {
    type: Boolean,
    default: false,
  },
  pagination: {
    type: Object,
    default: () => ({
      pageNo: 1,
      pageSize: 10,
    }),
  },
  actionsWidth: {
    type: String,
    default: '180',
  },
});
const emit = defineEmits(['update:pagination', 'refresh']);
// 分頁(yè)大小變化
const handleSizeChange = (pageSize) => {
  emit('update:pagination', { ...props.pagination, pageSize });
  emit('refresh');
};
// 當(dāng)前頁(yè)變化
const handleCurrentChange = (pageNo) => {
  emit('update:pagination', { ...props.pagination, pageNo });
  emit('refresh');
};
</script>
<style scoped>
.table-with-pagination {
  margin-top: 20px;
}
.pagination {
  margin-top: 20px;
  text-align: right;
}
</style>

3. 使用示例

<template>
  <div>
    <!-- 搜索欄 -->
    <el-form :inline="true" :model="queryParams">
      <el-form-item label="任務(wù)名稱">
        <el-input v-model="queryParams.taskName" placeholder="請(qǐng)輸入任務(wù)名稱" />
      </el-form-item>
      <el-form-item>
        <el-button type="primary" @click="handleSearch">搜索</el-button>
      </el-form-item>
    </el-form>
    <!-- 表格組件 -->
    <TableWithPagination
      :table-data="tableData"
      :columns="columns"
      :total="total"
      :loading="loading"
      :pagination="pagination"
      @update:pagination="handlePaginationChange"
      @refresh="fetchData"
    >
      <!-- 自定義列 -->
      <template #status="{ row }">
        <el-tag :type="row.status === 1 ? 'success' : 'danger'">
          {
  { row.status === 1 ? '啟用' : '禁用' }}
        </el-tag>
      </template>
      <!-- 操作列 -->
      <template #actions="{ row }">
        <el-button type="primary" size="small" @click="handleEdit(row)">
          編輯
        </el-button>
        <el-button type="danger" size="small" @click="handleDelete(row)">
          刪除
        </el-button>
      </template>
    </TableWithPagination>
  </div>
</template>
<script setup>
import { ref, onMounted } from 'vue';
import TableWithPagination from './components/TableWithPagination.vue';
import { fetchTaskList } from '@/api/task'; // 假設(shè)有一個(gè)獲取任務(wù)列表的 API
// 表格列配置
const columns = [
  { prop: 'taskName', label: '任務(wù)名稱' },
  { prop: 'taskType', label: '任務(wù)類型' },
  { prop: 'status', label: '狀態(tài)', slot: 'status' }, // 使用自定義列
];
// 表格數(shù)據(jù)
const tableData = ref([]);
const total = ref(0);
const loading = ref(false);
// 查詢參數(shù)
const queryParams = ref({
  taskName: '',
});
// 分頁(yè)參數(shù)
const pagination = ref({
  pageNo: 1,
  pageSize: 10,
});
// 獲取數(shù)據(jù)
const fetchData = async () => {
  try {
    loading.value = true;
    const res = await fetchTaskList({
      ...queryParams.value,
      ...pagination.value,
    });
    tableData.value = res.data.list;
    total.value = res.data.total;
  } catch (error) {
    console.error('獲取數(shù)據(jù)失?。?, error);
  } finally {
    loading.value = false;
  }
};
// 分頁(yè)變化
const handlePaginationChange = (newPagination) => {
  pagination.value = newPagination;
  fetchData();
};
// 搜索
const handleSearch = () => {
  pagination.value.pageNo = 1; // 重置頁(yè)碼
  fetchData();
};
// 編輯
const handleEdit = (row) => {
  console.log('編輯：', row);
};
// 刪除
const handleDelete = (row) => {
  console.log('刪除：', row);
};
// 初始化加載數(shù)據(jù)
onMounted(() => {
  fetchData();
});
</script>

父組件中使用 TableWithPagination以上就是封裝 Vue 3 和 Element Plus 中封裝一個(gè)通用的列表表格組件，將表格和分頁(yè)邏輯封裝在一個(gè)組件中，便于維護(hù)和擴(kuò)展。

到此這篇關(guān)于vue3 + ElementPlus 封裝列表表格組件包含分頁(yè)的文章就介紹到這了,更多相關(guān)vue ElementPlus封裝表格組件內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: