# 表格高级模式 ## 目录 - [通用表格 (commonTable)](#通用表格-commontable) - [树形表格 (treeTable)](#树形表格-treetable) - [分组表格 (groupingTable)](#分组表格-groupingtable) - [合并单元格 (mergeTable)](#合并单元格-mergetable) - [锁定列 (lockTable)](#锁定列-locktable) - [批注表格 (postilTable)](#批注表格-postiltable) - [行内编辑 (redactTable)](#行内编辑-redacttable) - [标记表格 (signTable)](#标记表格-signtable) - [打印表格 (printTable)](#打印表格-printtable) - [统计表格 (statisticsTable)](#统计表格-statisticstable) - [扩展表格 (extension)](#扩展表格-extension) - [复杂表头 (complexHeader)](#复杂表头-complexheader) - [表格树 (tableTree)](#表格树-tabletree) --- ## 源码位置 ``` $ccWorkDir/web/apps/jnpf-web-apps-main/src/views/extend/tableDemo/ ``` --- ## 通用表格 (commonTable) ### 源码 ``` tableDemo/commonTable/index.vue ``` ### 核心模式 ```typescript const [registerTable, { reload }] = useVxeTable({ api: getTableList, // 数据接口 columns, // 列定义 useSearchForm: true, // 启用搜索表单 formConfig: { // 搜索表单配置 schemas: searchSchemas }, actionColumn: { // 操作列 width: 100, title: '操作', dataIndex: 'action' } }); ``` ### 列定义 ```typescript const columns: BasicColumn[] = [ { title: '名称', dataIndex: 'name', width: 150 }, { title: '编码', dataIndex: 'code', width: 120 }, { title: '状态', dataIndex: 'status', slots: { default: 'status' } }, { title: '创建时间', dataIndex: 'createTime', width: 180, format: 'date|YYYY-MM-DD' }, { title: '操作', dataIndex: 'action', width: 120, fixed: 'right' } ]; ``` --- ## 树形表格 (treeTable) ### 源码 ``` tableDemo/treeTable/index.vue ``` ### 核心模式 ```typescript // 左侧树 + 右侧表格 // 表格搜索参数 const searchInfo = reactive({ typeId: '' }); const [registerTable, { reload }] = useVxeTable({ api: getTableListByType, searchInfo, // 传入树选择的参数 immediate: false // 延迟加载 }); ``` ### 关键点 - `BasicLeftTree`: 左侧树组件 - `searchInfo`: 响应式对象,接收树选择的值 - `immediate: false`: 延迟加载,等树选择后再加载 --- ## 分组表格 (groupingTable) ### 源码 ``` tableDemo/groupingTable/index.vue ``` ### 核心模式 ```typescript const [registerTable, { reload }] = useVxeTable({ api: getTableListAll, isTreeTable: true, // 开启树形模式 pagination: false, // 禁用分页 afterFetch: (data) => { // 将扁平数据转换为树结构 let list = cloneDeep(industryTypeList); for (const e of list) { e.isParent = true; e.children = []; for (const datum of data) { if (e.id == datum.projectType) e.children.push(datum); } } return list; } }); ``` ### 关键点 - `isTreeTable: true`: 启用分组 - `pagination: false`: 分组模式下通常禁用分页 - `afterFetch`: 数据转换,构造父子关系 --- ## 合并单元格 (mergeTable) ### 源码 ``` tableDemo/mergeTable/index.vue ``` ### 核心模式 ```typescript const [registerTable, { reload }] = useVxeTable({ spanMethod: ({ row, column, rowIndex, columnIndex }) => { // 合并相同值的单元格 if (columnIndex === 4 || columnIndex === 6) { if (rowIndex > 0 && row[column.property] === tableData[rowIndex - 1][column.property]) { return { rowspan: 0, colspan: 0 }; } let rspan = 1; for (let i = rowIndex + 1; i < tableData.length; i++) { if (tableData[i][column.property] === row[column.property]) { rspan++; } else break; } return { rowspan: rspan, colspan: 1 }; } } }); ``` ### 关键点 - `spanMethod`: 合并算法,返回 `{rowspan, colspan}` - 返回 `{rowspan: 0, colspan: 0}` 表示被合并 --- ## 锁定列 (lockTable) ### 源码 ``` tableDemo/lockTable/index.vue ``` ### 核心模式 ```typescript const columns: BasicColumn[] = [ { title: '项目名称', dataIndex: 'projectName', minWidth: 200, fixed: 'left' }, { title: '项目编码', dataIndex: 'projectCode', width: 160, fixed: 'left' }, // ... 中间列不固定 ... { title: '操作', dataIndex: 'action', width: 100, fixed: 'right' } ]; ``` ### 关键点 - `fixed: 'left'`: 左侧锁定 - `fixed: 'right'`: 右侧锁定 - `minWidth`: 防止列宽过小 --- ## 批注表格 (postilTable) ### 源码 ``` tableDemo/postilTable/index.vue ``` ### 核心模式 ```typescript // 列定义 { title: '批注', dataIndex: 'postilCount', slots: { default: 'postilCount' } } // 模板 // 打开批注弹窗 function addOrUpdateHandle(id) { openPostilModal(true, { id }); } ``` ### 关键点 - 批注数量字段 `postilCount` - 点击打开批注详情弹窗 --- ## 行内编辑 (redactTable) ### 源码 ``` tableDemo/redactTable/index.vue ``` ### 核心模式 ```typescript // 点击切换编辑模式 // 点击行开启编辑 function handleRowClick({ record }) { state.tabClickId = record.id; } // 保存编辑 async function handleSave(row) { await updateRowData(row); state.tabClickId = null; } ``` ### 关键点 - `tabClickId`: 记录当前编辑行 - 动态组件切换编辑控件 - 支持多种控件类型 --- ## 标记表格 (signTable) ### 源码 ``` tableDemo/signTable/index.vue ``` ### 核心模式 ```typescript // 颜色标记下拉 项目标记 ``` ### 关键点 - 颜色选项列表 `options` - `handleSign`: 更新行的标记颜色 --- ## 打印表格 (printTable) ### 源码 ``` tableDemo/printTable/index.vue ``` ### 核心模式 ```typescript import printJS from 'print-js'; function handlePrint() { printJS({ printable: state.list, // 数据 properties: columnsList.map((o) => ({ field: o.dataIndex, displayName: o.title })), type: 'json', gridStyle: 'border: 1px solid lightgray;' }); } ``` ### 关键点 - 使用 `printJS` 库 - `properties`: 字段映射 --- ## 统计表格 (statisticsTable) ### 源码 ``` tableDemo/statisticsTable/index.vue ``` ### 核心模式 ```typescript const [registerTable, { reload }] = useVxeTable({ showFooter: true, footerMethod: ({ columns, data }) => { return [columns.map((column, columnIndex) => { if (![9, 10, 11].includes(columnIndex)) return ''; // 非统计列 let sumVal = data.reduce((sum, d) => { return sum + Number.parseFloat(d[column.property] || 0); }, 0); return Number.isNaN(sumVal) ? '' : sumVal.toFixed(2); })]; } }); ``` ### 关键点 - `showFooter: true`: 显示汇总行 - `footerMethod`: 返回汇总数据 --- ## 扩展表格 (extension) ### 源码 ``` tableDemo/extension/index.vue ``` ### 核心模式 ```typescript // 展开行显示嵌套表格 expandConfig: { lazy: true, loadMethod({ row }) { return new Promise((resolve) => { getCityList(row.id).then((res) => { row.list = res.data.list; resolve(row); }); }); } } // 嵌套 VxeGrid ``` ### 关键点 - `expandConfig.lazy`: 懒加载展开数据 - `loadMethod`: 返回 Promise - 嵌套 `VxeGrid` 显示子数据 --- ## 复杂表头 (complexHeader) ### 源码 ``` tableDemo/complexHeader/index.vue ``` ### 核心模式 ```typescript const columns: BasicColumn[] = [ { title: '相关费用', width: 240, align: 'center', children: [ { title: '费用金额', dataIndex: 'costAmount', width: 100 }, { title: '已用金额', dataIndex: 'tunesAmount', width: 100 }, { title: '预计收入', dataIndex: 'projectedIncome', width: 100 } ] } ]; ``` ### 关键点 - `children`: 定义子列 - 多层表头嵌套 --- ## 表格树 (tableTree) ### 源码 ``` tableDemo/tableTree/index.vue ``` ### 核心模式 ```typescript const [registerTable, { expandAll }] = useVxeTable({ isTreeTable: true, immediate: false }); // 字典数据作为树 state.industryTypeList = await baseStore.getDictionaryData('IndustryType'); ``` ### 关键点 - `isTreeTable: true`: 纯树形表格 - 树形数据来自数据字典 --- ## 通用 API 模式 ### 列表查询 ```typescript import { getTableList, createRecord, updateRecord, deleteRecord } from '@/api/xxx'; const [registerTable, { reload, deleteTableDataRecord }] = useVxeTable({ api: getTableList, columns, actionColumn: { width: 120, title: '操作', dataIndex: 'action' } }); // 新增 function handleAdd() { openModal(true, {}); } // 编辑 function handleEdit(record) { openModal(true, record); } // 删除 async function handleDelete(record) { await deleteRecord(record.id); deleteTableDataRecord(record.id); reload(); } ``` --- ## 下一步 - [表单高级模式](11-form-patterns.md) - [示例参考](12-examples/workSystem-examples.md) - [示例参考](12-examples/extend-examples.md)