npm 包 natninter 使用教程

natninter 是一个用于在 Web 应用程序中管理国际化和本地化内容的 npm 包。它提供了一种简单的方法来实现多语言文本的转换和本地化，支持多种语言，并且易于使用和扩展。本文将介绍如何使用 natninter 以及它的一些特性和技巧。

安装

在使用 natninter 之前，需要使用 npm 安装该包：

npm install natninter --save

使用

初始化

在使用 natninter 之前需要进行一些初始化。首先，在应用程序中引入 natninter 并创建一个实例：

import { Natninter } from 'natninter';

const ninter = new Natninter({
  defaultLang: 'en',
  supportedLangs: ['en', 'zh'],
  fallbackLang: 'en',
});

该实例的 defaultLang 属性用于指定默认语言，supportedLangs 属性指定支持的语言列表，fallbackLang 属性指定当请求的语言不受支持时应使用的回退语言。

翻译

要在 HTML 中翻译文本，首先需要为每个需要翻译的文本添加一个 data-natninter-key 属性，并将该属性设置为要翻译的内容：

<span data-natninter-key="hello">Hello</span>

然后，使用 natninter 实例的 translate 方法来翻译该文本：

ninter.translate();

如果当前语言不是默认语言，那么该方法将使用 fallbackLang 属性将文本翻译为默认语言，并对文本中的 {} 占位符进行替换。如果当前语言受支持，该方法将使用当前语言翻译文本。

改变语言

要改变当前语言，可以使用 natninter 实例的 setLanguage 方法。例如，以下代码将当前语言设置为中文：

ninter.setLanguage('zh');

这将立即更新所有已翻译的文本，并在下一次调用 translate 方法时使用新的语言。

高级功能

自定义翻译器

natninter 允许您向其添加自定义翻译器。翻译器是一个简单的函数，它根据当前语言和需要翻译的文本返回翻译后的文本。例如，以下代码向 natninter 添加了一个翻译器，该翻译器使用 Google Translate API 翻译文本：

const googleTranslate = async (language, text) => {
  const url = `https://translate.googleapis.com/translate_a/single?client=gtx&sl=en&tl=${language}&dt=t&q=${encodeURI(text)}`;
  const res = await fetch(url);
  const data = await res.json();
  return data[0][0][0];
};

ninter.addTranslator(googleTranslate);

一旦添加了自定义翻译器，natninter 将在翻译文本时使用该翻译器。

嵌套键

有时，需要翻译具有嵌套键的对象。例如，以下对象包含嵌套的键：

const messages = {
  hello: 'Hello',
  messages: {
    greeting: 'Welcome',
  },
};

要翻译该对象的所有键，可以使用 natninter 实例的 translateObject 方法：

ninter.translateObject(messages);

该方法将翻译 messages 对象及其所有嵌套键的值，并将翻译结果保存到一个新对象中。

总结

natninter 是一个简单易用的国际化和本地化 npm 包，它提供了多语言文本翻译、多语言支持和自定义翻译器等高级功能。通过本文，您可以了解如何使用 natninter 进行简单和复杂的多语言文本翻译。如果您需要在 Web 应用程序中实现国际化和本地化，natninter 是一个很好的选择。

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/102176