前端开发中，国际化是一个必备的功能，而 @gongt/i18n-server 这个 npm 包就是一个快速实现国际化的解决方案。本文将分享该 npm 包的使用教程，以及详细的代码示例，以便读者能够快速上手。
包的介绍
@gongt/i18n-server 是一个用于前后端分离架构下的国际化解决方案。使用该包，开发者可以将所有的国际化文本存储在本地文件中，通过 REST API 的形式把需要的文本推送到前端。这种方式的好处是，不同的前端应用程序可以共享同一个文本资源库，简化了国际化的部署过程。
安装 @gongt/i18n-server
首先，需要安装 @gongt/i18n-server 包。可以通过以下命令进行安装：
npm install @gongt/i18n-server --save
引入包并配置
在项目的主文件中，一般是 server.js 或者 app.js，需要引入并配置 @gongt/i18n-server 包。示例代码如下：
-- -------------------- ---- ------- ----- ---- - ---------------- ----- ---- - ------------------------------ ----- ----------- - -------------------- --------- ----- ---- - ---------------- -- ----- ---------------- -------- ------ --------- ---------- ------------ --------------- ----- ----------- - --- ---------------------- ----------------- ------------ -------- -------------------------- ----
locales：配置当前支持的所有语言选项；directory：配置国际化文件所存放的文件夹位置；objectNotation：国际化文件采用对象表示法而非 JSON 形式；jsonSpaces：当采用对象表示法时，为 JSON 数据设置缩进空格数；translationsPath：国际化文件所存放的文件夹位置；siteUrl：用于控制台信息输出及日志记录。（可选设置）
在页面中使用国际化文本
接下来，我们需要在前端页面中使用国际化文本。在前端代码中可以直接通过 REST API 获取国际化文本。示例代码如下：
<h1>{{ $gettext('Hello World') }}</h1>
<p>{{ $ngettext('%d item', '%d items', 5) }}</p>$gettext()：获取字符串的翻译；$ngettext()：获取由$p1参数决定的字符串，其中$p1为一个数字。
动态修改当前语言
有时，我们需要动态修改当前语言，在 @gongt/i18n-server 中，我们只需要设置一下本地存储中的语言信息就可以实现这个功能。示例代码如下：
i18n.setLocale(req, 'zh-CN');
req：当前请求的 request 信息对象；'zh-CN'：需要切换到的语言类型。
验证是否支持指定语言
为了防止用户输入或者系统默认语言选择错误导致报错，我们需要进行语言验证。示例代码如下：
const supported = i18n.verifySupportLanguage('zh-CN');'zh-CN'：需要判断是否支持的语言类型。
本地化日期和时间
在使用国际化过程中，处理时间和日期格式是必不可少的。在 @gongt/i18n-server 中，我们可以使用 moment.js 对日期和时间进行本地化处理。示例代码如下：
const moment = require('moment');
const now = moment().locale(req.getLocale());
console.log(now.format('LLLL')); // 将输出本地化时间总结
通过本文的讲解，你应该能够了解 @gongt/i18n-server 的使用方法，并在实际开发中上手去应用。该 npm 包为前端开发者提供了一个快速部署国际化解决方案的好工具。如果想要了解更多 @gongt/i18n-server 中的 API，请查看官方文档。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/109931