KendoUI导出Excel时如何在表格表头上方添加自定义行？

问题分析 #

当前代码里，sheet的filter仅指定了列范围（from:1, to:2），默认会把筛选器应用到这些列的所有行，包括表头上方的自定义行，导致筛选器覆盖了自定义行。直接用单元格地址（如"A2"）会损坏Excel文件，因为Kendo的filter不支持这种格式。

解决方案 #

利用KendoUI Workbook中sheet.filter的**row属性**，指定筛选器起始的行索引（行索引从1开始计数），让筛选器仅作用于表格的表头和数据行，避开上方的自定义行。

修改后的代码示例 #

var workbook = new kendo.ooxml.Workbook({
  sheets: [
      {
          // 筛选器从第2行（表格表头行）开始，作用于第1-2列
          filter: { from: 1, to: 2, row: 2 },
          rows: [
            // 自定义行（第1行，不受筛选器影响）
            { cells: [ { value: "pre table header", colSpan: 4 } ] },

            // 表格表头（第2行，筛选器起始行）
            { cells: [ { value: "First Name" }, { value: "Last Name" } ] },
            // 表格数据行
            { cells: [ { value: "John" }, { value: "Doe" } ] },
            { cells: [ { value: "Jane" }, { value: "Doe" } ] }
          ]
      }
  ]
});
kendo.saveAs({
  dataURI: workbook.toDataURL(),
  fileName: "Test.xlsx"
});

关键说明 #

• row参数定义了筛选器所在的起始行，这里设置为2，对应表格的表头行（自定义行是第1行）。
• 列索引from和to依然使用数字（从1开始），不能用单元格地址字符串，否则会导致Excel文件损坏。
• 自定义行的colSpan可以根据实际列数调整，确保内容跨列显示正常。

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