国际化（i18n）

Molecule 内置了一个简单的国际化（i18n）方案，支持我们基本的国际化需求。我们内置了简体中文（zh-CN）、英文（en 默认）和韩文（ko-KR）3 种基本的语言。

tip

本文内容中的所有代码，都以 Quick Start 中的 molecule-demo 项目为基础演示。

切换语言

默认我们提供了2 种方法切换。第一种使用 Command/Ctrl + Shift + L 快捷键：

第二种，打开使用快捷键 Command/Ctrl + , 在 Editor 中打开设置（Settings) 面板，修改 JSON 配置中的 locale 字段：

修改完成后，Molecule 会在 通知栏（Notification）弹出更新消息，我们选择 Reload 即可重新加载。

本地化服务（LocaleService） 对象

LocaleService 提供了一些基础的 API 方法，这些方法可以帮助我们完成对国际化功能的扩展，例如：

本地化(localize)一个对象:

molecule.locale.localize('sourceKey', 'default value');

设置当前的本地化语言：

// Set the zh-CN as the current locale language
molecule.locale.setCurrentLocale('zh-CN');

自定义语言

国际化语言（i18n） 同样是 Molecule 的一种扩展程序，我们提供了一种非常简便的自定义语言的方式, 支持使用 JSON 文件来定义国际化语言包数据。

我们一起来看个例子！

首先我们可以在自己项目中的 extensions 目录下，新建一个 i18n 的文件夹

src/extensions/i18n
├── index.ts
└── zh-CN.json

index.ts 用来定义本地化扩展对象

import { IContributeType, IExtension } from '@dtinsight/molecule/esm/model';

const zhCN = require('./zh-CN.json');
const locales = [zhCN];

export const ExtendLocales: IExtension = {
    id: 'ExtendLocales',
    name: 'Extend locales',
    contributes: {
        [IContributeType.Languages]: locales,
    },
};

zh-CN.json 为 ILocale 类型的语言包资源文件:

{
    "id": "custom-zh-CN",
    "name": "简体中文 - 自定义",
    "inherit": "zh-CN",
    "source": {
        "menu.file": "文件",
        "menu.newFile": "新建任务",
        "demo.running": "运行",
        "demo.dataSourceManagement": "数据源管理",
        "demo.terminal": "终端"
    }
}

其中 inherit 是可选项，表示是否继承已存在的（zh-CN/en) 的语言文件，source 为具体的本地化数据，以 key-value 的形式表示。

添加完成后，刷新整个页面，我们可以通过 Command/Ctrl + Shift + L 快捷键打开语言切换面板，找到 简体中文 - 自定义 选项。

info

遗憾的是，Molecule 虽然使用了 React 技术来构建整个应用，但是因为架构的原因， 目前无法做到切换后实时切换语言，需要重新加载整个页面应用，才能刷新语言环境。