English | 简体中文

The purpose of this plugin is to set the interface language when using monaco-editor. The main implementation idea is to override the monaco-editor/esm/vs/nls.js file to achieve the effect of interface language switching.

The main difference between 2.x and 1.x lies in the version of monaco-editor.

• The 2.x: When your product needs to support internationalization (the product page supports switching interface languages), please use version 2.x. It has been verified with monaco-editor versions 0.52.2.
• The 1.x: When your product needs to support internationalization (the product page supports switching interface languages), please use version 1.x. It has been verified with monaco-editor versions 0.30.1 and 0.31.1.
• The 0.x: When your product only has one interface language (does not need to support internationalization, such as only supporting Chinese), please use version 0.x. It has been verified with monaco-editor versions 0.30.1 and 0.31.1.

• npm install monaco-editor-i18n-plugin -D

The used src/locale/dt-zh-hans.json is lite based on vscode-loc/i18n/zh-hans.

The used src/locale/zh-hans.json is from vscode-loc/i18n/zh-hans。

If you want to use another languages or if the simplified src/scale/dt-zh-hans.json file does not meet the requirements, you can find JSON files in other languages in vscode-loc/i18n, and place them in your project folder for custom path usage.

• ko.config.js ko - Project toolkit for React Applications

const MonacoEditorI18nPlugin = require('monaco-editor-i18n-plugin');

const plugin = [
    ...,
    {
        key: 'WebpackPlugin',
        action: 'add',
        opts: {
            name: 'MonacoEditorI18nPlugin',
            fn: () => {
                return new MonacoEditorI18nPlugin({
                    windowKey: '__DT_LOCALE__',
                    localStorageKey: 'dt-locale',
                });
            },
        },
    }
]

• webpack.config.js

const MonacoEditorI18nPlugin = require('monaco-editor-i18n-plugin');

module.exports = {
    ...,
    plugins: [
        new MonacoEditorI18nPlugin({
            windowKey: '__DT_LOCALE__',
            localStorageKey: 'dt-locale',
        })
    ],
    ...,
};

The interface language content used needs to be mounted on the window object in the engineering code, with the default key value is __DT_LOCALE__. En US is the default language for monaco-editor, and a value of an empty object is sufficient. The subsequent reading of interface language content will be done from the window object. The mounting example is as follows:

import dtZhHans from 'monaco-editor-i18n-plugin/out/locale/dt-zh-hans.json';
import zhHant from './zh-hant.json';

// Mount the interface language content onto the window object
window.__DT_LOCALE__ = {
    'zh-hant': zhHant?.contents || {},
    'dt-zh-hans': dtZhHans?.contents || {},
    'en-US': {},
};

When switching interface languages, it is necessary to synchronize the language name to the localStorage. The switching example is as follows:

function setLocale(value: string) {
    window.localStorage.setItem('dt-locale', value);
}

setLocale('dt-zh-hans');

Important

• If the interface language of monaco-editor does not change with the product page, please note that the mounting timing of window.__DT_LOCALE__ should be as early as possible.

• The currently verified versions of monaco-editor are 0.52.2.
• The corresponding version of vscode doc is 1.91.1.
• If custom language doesn't work, it may be due to a mismatch between the versions of the two packages. The JSON file structure in later versions of vscode-loc has changed (like 1.63.3 and 1.91.1), Please verify other versions yourself.