最新版本v1.0.60
Table 表格 - 导出数据
通过内置的导出功能,可以将表格数据导出为 CSV、JSON、TXT、XML、HTML、XLSX 等多种格式,支持自定义列、格式化内容、排除列等高级配置。
导出数据
最基础的导出方式,通过组件实例方法 exportData() 将表格数据导出为 CSV 文件。
导出数据
导出 TXT 格式
TXT 格式采用 Tab 分隔列,可以直接粘贴到 Excel 中。
导出 TXT
导出 XML 格式
导出标准 XML 结构,适用于与其他系统的数据交换。
导出 XML
导出 HTML 格式
导出带样式的 HTML 表格文件,可直接在浏览器中打开查看。
导出 HTML
导出 CSV 格式
CSV 导出支持含序号列,自动添加 BOM 头确保 Excel 正确显示中文。
导出 CSV
导出 JSON 格式
保持原始数据类型不变的 JSON 格式导出。
导出 JSON
导出 Excel 格式
导出为 .xlsx 格式的 Excel 文件,支持自动计算列宽、自定义工作表名称等高级功能。
提示: Excel 导出依赖
xlsx库,导出的文件可直接用 Microsoft Excel、WPS 等软件打开。
导出 Excel
自定义数据
通过 data 参数指定导出的数据,可以实现筛选导出。
自定义数据
格式化导出内容
通过 formatCell 回调函数自定义单元格导出值,如添加货币符号、状态图标等。
格式化导出
高级导出
可配置导出格式、文件名、是否含序号和表头,并通过 afterExport 回调获取导出结果。
高级导出
排除列
通过 excludeColumns 指定不需要导出的列。
排除列
指定列
通过 columns 指定只导出哪些列。
指定列
自定义列标题
通过 columnTitles 自定义导出时的列标题,如导出英文表头。
自定义列标题
自定义导出类型
通过下拉菜单选择导出格式。
自定义导出类型
服务端导出
对于超大数据或需要生成 XLSX / PDF 格式的场景,建议在服务端处理导出。
服务端导出
自定义导出模式
设置 mode: 'string' 可以获取导出内容字符串而不触发下载,适用于复制到剪贴板或二次处理。
自定义导出模式
API
exportData(config?) 方法
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| type | 导出格式 | 'csv' | 'json' | 'txt' | 'xml' | 'html' | 'xlsx' | 'csv' |
| filename | 文件名(不含扩展名) | string | 'export' |
| includeHeader | 是否包含表头 | boolean | true |
| showIndex | 是否包含序号列 | boolean | false |
| indexTitle | 序号列标题 | string | '序号' |
| columns | 指定导出列(prop 数组) | string[] | 全部可见列 |
| excludeColumns | 排除列(prop 数组) | string[] | — |
| visibleOnly | 是否只导出可见列 | boolean | true |
| data | 自定义导出数据 | Record<string, unknown>[] | 当前表格数据 |
| columnTitles | 自定义列标题映射 | Record<string, string> | — |
| formatCell | 格式化单元格内容 | (value, column, row) => string | — |
| separator | CSV 分隔符 | string | ',' |
| bom | 是否添加 BOM 头 | boolean | true |
| mode | 导出模式 | 'download' | 'string' | 'download' |
| beforeExport | 导出前回调 | () => boolean | — |
| afterExport | 导出后回调 | (type) => void | — |
| sheetName | 工作表名称(仅 XLSX) | string | 'Sheet1' |
| columnWidths | 列宽配置(仅 XLSX),如 { name: 15, address: 30 } | Record<string, number> | — |
| defaultColWidth | 默认列宽(仅 XLSX) | number | 12 |
| autoWidth | 是否自动调整列宽(仅 XLSX) | boolean | true |
各格式说明
| 格式 | 扩展名 | MIME | 特点 |
|---|---|---|---|
| CSV | .csv | text/csv | 通用格式,Excel 可直接打开,自动添加 BOM |
| JSON | .json | application/json | 保持原始数据类型,适合程序间交换 |
| TXT | .txt | text/plain | Tab 分隔,可直接粘贴到 Excel |
| XML | .xml | application/xml | 标准 XML 结构,适合系统集成 |
| HTML | .html | text/html | 带样式的表格,浏览器可直接查看 |
| XLSX | .xlsx | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet | Excel 格式,支持自动列宽、多工作表 |