在前端開發(fā)中，封裝組件是必不可少的。今天就來封裝一個通用的列表表格組件，包含分頁功能，可以提高代碼的復(fù)用性和可維護性。

1. 組件設(shè)計

?Props：

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

Events：

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

Slots：

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

2. 封裝代碼

TableWithPagination.vue

<template><div class="table-with-pagination"><!-- 表格 --><el-table:data="tableData"borderstripev-loading="loading"style="width: 100%"><!-- 動態(tài)列 --><el-table-columnv-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-columnv-if="$slots.actions"label="操作"align="center":width="actionsWidth"><template #default="scope"><slot name="actions" :row="scope.row"></slot></template></el-table-column></el-table><!-- 分頁 --><el-paginationclass="pagination"backgroundlayout="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']);// 分頁大小變化
const handleSizeChange = (pageSize) => {emit('update:pagination', { ...props.pagination, pageSize });emit('refresh');
};// 當(dāng)前頁變化
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="請輸入任務(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è)有一個獲取任務(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: '',
});// 分頁參數(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;}
};// 分頁變化
const handlePaginationChange = (newPagination) => {pagination.value = newPagination;fetchData();
};// 搜索
const handleSearch = () => {pagination.value.pageNo = 1; // 重置頁碼fetchData();
};// 編輯
const handleEdit = (row) => {console.log('編輯：', row);
};// 刪除
const handleDelete = (row) => {console.log('刪除：', row);
};// 初始化加載數(shù)據(jù)
onMounted(() => {fetchData();
});
</script>

父組件中使用 TableWithPagination以上就是封裝?Vue 3 和 Element Plus 中封裝一個通用的列表表格組件，將表格和分頁邏輯封裝在一個組件中，便于維護和擴展。