Handsontable使用downloadFile插件导出时合并单元格失效问题咨询

原因分析 #

• CSV格式本身不支持单元格合并：CSV是纯文本的逗号分隔格式，仅存储每个单元格的原始数据，不包含任何单元格样式、合并状态等元信息，因此导出后必然会还原为原始的单元格数据结构。
• Handsontable的合并是UI层渲染逻辑：mergeCells配置仅控制前端表格的渲染效果，不会修改底层的data数组内容。导出插件读取的是原始data数据，自然无法体现合并单元格的设置。

解决方案 #

若要保留合并单元格的结构，需要导出为支持单元格格式的文件（如Excel的XLSX格式）。Handsontable的exportFile插件支持XLSX导出，只需调整导出格式及相关配置：

修改后的导出代码 #

const exportPlugin = table.getPlugin('exportFile');
// 导出为XLSX文件并保留合并单元格
exportPlugin.downloadFile('xlsx', {
  bom: true,
  columnHeaders: false,
  rowHeaders: false,
  exportHiddenColumns: true,
  exportHiddenRows: true,
  fileExtension: 'xlsx',
  filename: 'Excel-[YYYY]-[MM]-[DD]',
  mimeType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
  exportMergeCells: true, // 关键配置：启用合并单元格导出
});

额外说明 #

1. 确保你的Handsontable版本支持XLSX导出（多数新版本均支持）；
2. 修正原始代码中的语法错误：最后一行多余的})需要删除，否则会导致代码执行失败。

内容的提问来源于stack exchange，提问作者Aubry