如何在AG Grid的Excel导出中显示错误类型字符串而非数字？

问题核心：AG Grid的Excel导出默认取字段原始值，而CSV导出默认使用显示值（即valueFormatter处理后的结果），因此需要显式配置Excel导出时使用格式化后的字符串。

方案1：列级配置exportValueFormatter #

直接在列定义中添加exportValueFormatter属性，复用已有的格式化函数，指定Excel导出时使用该逻辑处理值：

const gridOptions = {
  columnDefs: [
    {
      headerName: "Error Type",
      field: "a",
      valueFormatter: errorFormatter,
      // 配置导出时使用格式化后的字符串
      exportValueFormatter: errorFormatter
    }
  ],
  // 其余配置保持不变
};

方案2：全局导出配置processCellCallback #

如果需要对多列统一处理，可以在调用Excel导出时，通过processCellCallback自定义单元格导出内容：

function exportToExcel() {
  gridApi.exportDataAsExcel({
    processCellCallback: function(params) {
      // 仅对字段"a"应用格式化，其他字段保留原始值
      if (params.column.colId === 'a') {
        return errorFormatter(params);
      }
      return params.value;
    }
  });
}

原理说明 #

• CSV导出（exportDataAsCsv）默认读取单元格的显示值（通过getDisplayValue()获取，即valueFormatter处理后的结果）。
• Excel导出（exportDataAsExcel）默认读取单元格的原始值（通过getValue()获取，即字段存储的数字）。
• 通过exportValueFormatter或processCellCallback，可以强制Excel导出时使用格式化后的字符串。

修改后的完整示例代码 #

let gridApi;

const gridOptions = {
  columnDefs: [
    {
      headerName: "Error Type",
      field: "a",
      valueFormatter: errorFormatter,
      exportValueFormatter: errorFormatter
    }
  ],
  rowData: createRowData(),
  enableRangeSelection: true,
  enableFillHandle: true,
};

function errorFormatter(params) {
  if(params.value == null)
    return "";

  switch (params.value){
    case 0:
      return "No Error";
    case 1:
      return "Reading Error";
    case 2:
      return "Parsing Error";
  }
}

function createRowData() {
  const rowData = [];

  for (let i = 0; i < 100; i++) {
    rowData.push({
      a: Math.floor(Math.random() * 3)
    });
  }

  return rowData;
}

// 触发Excel导出的函数（可绑定到按钮点击事件）
function exportExcel() {
  gridApi.exportDataAsExcel();
}

document.addEventListener("DOMContentLoaded", function () {
  const gridDiv = document.querySelector("#myGrid");
  gridApi = agGrid.createGrid(gridDiv, gridOptions);
});

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