国际化

Presets 安装

每一个 Preset 都提供了对应的语言包，引入你所使用的 Preset 对应的语言包：

import { createUniver, defaultTheme, LocaleType, Tools } from '@univerjs/presets';
import { UniverSheetsAdvancedPreset } from '@univerjs/presets/preset-sheets-advanced';
import UniverPresetSheetsAdvancedZhCN from '@univerjs/presets/preset-sheets-advanced/locales/zh-CN';
import { UniverSheetsCorePreset } from '@univerjs/presets/preset-sheets-core';
import UniverPresetSheetsCoreZhCN from '@univerjs/presets/preset-sheets-core/locales/zh-CN';
 
const { univerAPI } = createUniver({
  locale: LocaleType.ZH_CN,
  locales: {
    zhCN: Tools.deepMerge(
      {},
      UniverPresetSheetsCoreZhCN,
      UniverPresetSheetsAdvancedZhCN,
    ),
  },
  theme: defaultTheme,
  presets: [
    UniverSheetsCorePreset(),
    UniverSheetsAdvancedPreset(),
  ],
});

高级安装

0.1.13 版本后，Univer 不再内置任何语言包，所有语言包均由插件提供。

如果你觉得手动引入插件的语言包过于繁琐，我们还提供了一个构建工具插件，用于自动引入插件所需的语言包。请参考打包器插件获取更多信息。

如需手动添加语言包，你可以参考以下示例，根据需要引入对应的语言包并组装成对象传入 Univer 实例：

import { LocaleType, Tools } from '@univerjs/core';
import DesignZhCN from '@univerjs/design/locale/zh-CN';
import UIZhCN from '@univerjs/ui/locale/zh-CN';
import DocsUIZhCN from '@univerjs/docs-ui/locale/zh-CN';
import SheetsZhCN from '@univerjs/sheets/locale/zh-CN';
import SheetsUIZhCN from '@univerjs/sheets-ui/locale/zh-CN';
import SheetsFormulaUIZhCN from '@univerjs/sheets-formula-ui/locale/zh-CN';
 
const univer = new Univer({
  theme: defaultTheme,
  locale: LocaleType.ZH_CN,
  locales: {
    [LocaleType.ZH_CN]: Tools.deepMerge(
      SheetsZhCN,
      DocsUIZhCN,
      SheetsUIZhCN,
      SheetsFormulaUIZhCN,
      UIZhCN,
      DesignZhCN,
    ),
  },
});

需要注意的是，由于 Webpack 4 并不支持 package.json 的 exports 字段，因此你可能会需要修改引入语言包的路径。

- import DesignZhCN from '@univerjs/design/locale/zh-CN';
+ import DesignZhCN from '@univerjs/design/lib/locale/zh-CN.json'

如果你使用了 TypeScript，也需要确认是否在 tsconfig.json 中配置了 resolveJsonModule 选项。

{
  "compilerOptions": {
+    "resolveJsonModule": true
  }
}

自定义语言包

Univer 也支持自定义语言包，你可以根据需要自行组装语言包对象并传入 Univer 实例。Univer 官方插件的语言包一般存放在 <rootDir>/packages/<PLUGIN_NAME>/locale 目录下，可供参考。

const univer = new Univer({
  theme: defaultTheme,
  locale: 'es-ES',
  locales: {
    'es-ES': {
      shortcut: {
        undo: 'Deshacer',
        redo: 'Rehacer',
      }
    },
  },
});

贡献语言包

Univer 目前提供了以下预设语言包：

zh-CN：简体中文
en-US：英文
zh-TW：繁体中文
ru-RU：俄文
vi-VN：越南文
fa_IR：波斯文

其他的语言尚未支持。我们欢迎来自五湖四海的开发者为 Univer 添加或者改进语言包，如果你有兴趣为 Univer 贡献翻译，请参考贡献指南。

高级安装使用 Facade API