如何为AntV S2库新增法语等自定义语言？

架构老林

2026-7-5

解决方案：为AntV S2新增法语自定义语言包

完全可以新增自定义语言（比如法语），核心思路是自定义对应语言的国际化配置对象，再注册到S2的locale管理器中，具体步骤如下：

1. 定义法语国际化配置

复制S2原生中英语言包的键结构，将所有文案替换为法语翻译。可以参考S2源码中zh-CN或en-US的locale文件，确保覆盖所有需要翻译的字段：

// 自定义法语locale配置
const FR_LOCALE = {
  common: {
    confirm: 'Confirmer',
    cancel: 'Annuler',
    reset: 'Réinitialiser',
    more: 'Plus',
  },
  table: {
    emptyText: 'Aucune donnée disponible',
    expand: 'Déplier',
    collapse: 'Replier',
    sort: {
      ascend: 'Trier par ordre croissant',
      descend: 'Trier par ordre décroissant',
      cancel: 'Annuler le tri',
    },
    filter: {
      title: 'Filtrer',
      confirm: 'Confirmer',
      cancel: 'Annuler',
      emptyText: 'Aucune option disponible',
    },
    // 补充其他表格相关文案，参考S2原生locale的完整结构
  },
  tooltip: {
    defaultTitle: 'Détails',
    total: 'Total',
  },
  // 其他模块文案（如工具栏、导出等）按需补充
};

2. 注册自定义语言包

通过S2Locale.register方法将法语配置注册到S2中：

import { S2Locale } from '@antv/s2';

// 注册法语，指定语言标识为'fr'
S2Locale.register('fr', FR_LOCALE);

3. 初始化表格时指定使用法语

在创建S2表格实例的配置中，设置locale为注册的语言标识'fr'：

import { PivotSheet } from '@antv/s2';

const s2Config = {
  locale: 'fr', // 指定使用法语
  // 其他表格配置项
};

const s2 = new PivotSheet(
  document.getElementById('container'),
  dataConfig,
  s2Config
);
s2.render();