@codeborne/i18n-json

中文文档
0.3.7发布于 2024/02/27ISCTypeScriptES Module零依赖近 30 天下载 2839

基于 json 的简单框架中立翻译,没有依赖性

中文使用文档
文档目录3 节
  1. 使用量
  2. 框架
  3. 后汇编步骤

@codeborne/i18n-json (英语)

简单的框架中和 json 翻译,没有依赖性.

npm install @codeborne/i18n-json

见 样本 如何构建您的翻译文件.

该格式还得到以下支持: 翻译工具图形界面。 。 。 .

使用量

在您的项目中创建 i18n.ts 用于进口的:

import langs from '../i18n/langs.json'
import {init} from '@codeborne/i18n-json'
export * from '@codeborne/i18n-json'

export async function initTranslations() {
  await init({langs})
}

那就打电话 await initTranslations() 在索引.ts中加载所选语言文件.

要翻译一个密钥,呼叫 _('your.translate.key') 或用替换: _('users.hello', {name: 'World'})

多元字符串也被支持: _('trees', {count: 1}),对于英语来说,它可能看起来像: "trees": "You have {count|one:# tree|other:# trees}" 俄语是: "trees": "У вас есть {count|one:одно дерево|few:# дерева|many:# деревьев}"。 。 。 . 由浏览器提供的多键 Intl.PluralRules 为语言.

更多例子见测试.

框架

库体非常小,具有零依赖性并具有框架不可知性. 你可以用到斯维尔特,反应,Vue或其他东西.

如果使用 SPA 框架并想要在"飞行"上切换语言(不重新加载页面),则需要添加一个 小包装 _ 函数.

例如,在Svelte中,您会使用商店设置/检索函数,然后将其作为 $_()。 。 。 .

后汇编步骤

您可以在构建时将默认 lang 中缺失的密钥/ 值添加到其它所有文件, 从而合并翻译文件, 而不需要在运行时对未翻译的密钥进行倒置 .

i18n-compile <srcDir> <dstDir>

然后在prod模式下禁用动态回落到默认状态,例如. await init({langs, fallbackToDefault: import.meta.env.DEV})。 。 。 .

版本与发布记录

@codeborne/i18n-json 共发布 18 个版本,首次发布于 2022/05/12;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.3.7latest2024/02/272 年前
0.3.62023/11/102 年前
0.3.52023/11/083 年前
0.3.42023/08/033 年前
0.3.32023/08/033 年前
0.3.22023/08/033 年前

关于 @codeborne/i18n-json 的常见问题

@codeborne/i18n-json 是什么?

基于 json 的简单框架中立翻译,没有依赖性

如何安装 @codeborne/i18n-json?

在项目目录运行 npm install @codeborne/i18n-json,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 i18n-compile,可以用 npx i18n-compile 直接运行。

@codeborne/i18n-json 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@codeborne/i18n-json 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@codeborne/i18n-json 可以商用吗?

@codeborne/i18n-json 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@codeborne/i18n-json 的下载量有多少?

根据 npm 官方下载统计,@codeborne/i18n-json 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,839 次,日均约 95 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@codeborne/i18n-json 还在维护吗?

最新版本 0.3.7 发布于 2024/02/27(2 年前);至今共发布 18 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/05/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。