为 i18n 应用程序创建语言切换器

Question

我正在学习如何在应用程序上实现 Lingui(i18n)。一切都设置好了，但我想知道我应该如何创建一个语言切换器来在我的应用程序的语言目录之间进行切换。

这是我的 index.js 文件

import React, { useEffect } from "react";
import { render } from "react-dom";
import App from "./App";

import { I18nProvider } from "@lingui/react";
import { i18n } from "@lingui/core";
import { defaultLocale, dynamicActivate } from "./i18n";

const Translation = () => {
    useEffect(() => {
        dynamicActivate(defaultLocale);
    }, []);

    return (
        <I18nProvider i18n={i18n}>
            <App />
        </I18nProvider>
    );
};

render(<Translation />, document.getElementById("root"));

我的 App.js 文件

import "./App.css";
import { Trans } from "@lingui/macro";

function App() {
    return (
        <div className="App">
            <header className="App-header">
                <h1>
                    <Trans>HELLOO</Trans>
                </h1>
                <p>
                    <Trans>it's me.</Trans>

                </p>
            </header>
        </div>
    );
}

export default App;

和 i18n.ts 文件

import { i18n } from '@lingui/core';

export const locales = {
  en: "English",
  es: "Spanish",
  fr: "French",
};

export const defaultLocale = "fr";

/**
* We do a dynamic import of just the catalog that we need
* @param locale any locale string
*/

export async function dynamicActivate(locale: string) {
  const { messages } = await import(`./locales/${locale}/messages`)
  i18n.load(locale, messages)
  i18n.activate(locale)
}

每次我指定 es,en 或 fr defaultLocale 时，语言都会发生变化，但我希望有一个语言按钮可以通过选择在页面上自动更改它。

ex: "export const defaultLocale = "fr";" （在 i18n.ts 中）

Answer 1

您可以使用i18n.activate() 方法切换到所需的语言环境。

i18n 对象 API 在 @js-lingui/core 中定义。

如果之前未加载，您还需要加载语言环境。

对于您的项目，您可以使用您已经创建的方便的dynamicActivate() 函数。

您的组件输出将如下所示：

<div>
    <Trans>Switch to:</Trans>
    <button
        onClick={() => dynamicActivate('en')}>
        English
    </button>
    <button
        onClick={() => dynamicActivate('fr')}>
        Français
    </button>
    <button
        onClick={() => dynamicActivate('es')}>
        Espanol
    </button>
</div>

它将呈现 3 个按钮 [English] [Français] [Espanol]，每个按钮都会加载并激活所需的语言环境。

最好将按钮标题保留为他们自己的语言，以便用户可以找到他们理解的语言。

作为对上述内容的补充，突出显示当前选择的语言并禁用按钮可能是有意义的。

我正在使用useLingui() 来获取指示当前语言的i18n.locale，并在下面的按钮之一上设置disabled 标志。

这是LanguageSelector.js组件的完整代码，你可以在App.js中使用它作为<LanguageSelector />。祝你的项目/学习好运。

import React from "react"
import { useLingui } from "@lingui/react"
import { Trans } from "@lingui/macro";
import { dynamicActivate } from "./i18n";

const LanguageSelector = () => {
    const { i18n } = useLingui();

    return <div>
            <Trans>Switch to:</Trans>
            <button
                onClick={() => dynamicActivate('en')}
                disabled={i18n.locale === 'en'}>
                English
            </button>
            <button
                onClick={() => dynamicActivate('fr')}
                disabled={i18n.locale === 'fr'}>
                Français
            </button>
            <button
                onClick={() => dynamicActivate('es')}
                disabled={i18n.locale === 'es'}>
                Espanol
            </button>
    </div>
};

export default LanguageSelector

更新：

此外，您可以将选定的语言环境保存到浏览器的LocalStorage

我们应该在每次调用dynamicActivate() 时保存语言环境：

const LOCAL_STORAGE_KEY = 'lang';

function dynamicActivate(locale: string) {
  // existing code here
  window.localStorage.setItem(LOCAL_STORAGE_KEY, locale);
}

显然，@lingui/detect-localelibrary 具有很好的覆盖范围，可以从包括 LocalStorage 在内的许多来源检测语言环境。

这里是如何应用它的：

import { detect, fromUrl, fromStorage, fromNavigator } from '@lingui/detect-locale';

// existing code from i18n.ts

export const locales = {
  en: "English",
  es: "Spanish",
  fr: "French",
};

export const defaultLocale = "en";

const LOCAL_STORAGE_KEY = 'lang';

// checks that detected locale is available
const isLocaleValid = (locale: string | null) => `${locale}` in locales;

// returns locale 
export function getLocale() {
  const detectedLocale = detect(
    fromUrl("lang"), // for example http://localhost:3000/?lang=es
    fromStorage(LOCAL_STORAGE_KEY),
    fromNavigator(), // from system settings
    () => defaultLocale,
  );

  return isLocaleValid(detectedLocale) ? detectedLocale : defaultLocale;
}

最后一步是调用getLocale()，而不是一直使用defaultLocale。

    useEffect(() => {
        // With this method we dynamically load the catalogs
        dynamicActivate(getLocale());
    }, []);