@gravity-ui/i18n-core

中文文档
1.6.0发布于 2026/04/14MITTypeScriptESM + CJS构建来源已验证近 30 天下载 1.7万

这个 i18n- 核心数 图书馆是国际化(i18n)图书馆的基础. 建于顶上 @formatjs/intl (中文(简体) )。 。 。 .

中文使用文档
文档目录4 节
  1. 关键特性 :
  2. 使用实例:
  3. 使用量
  4. 地区倒计时

i18n- 核心数

这个 i18n- 核心数 图书馆是国际化(i18n)图书馆的基础. 建于顶上 @formatjs/intl (中文(简体) )。 。 。 .

关键特性 :

  1. 框架不可知论数字 : 被设计为与任何JavaScript或TypeScript项目相配合,基于反应与否.

  2. 建于 @ formatjs/ intl 上数字 : 利用@formatjs/intl强大的格式化和定制能力,提供行业标准本地化功能.

  3. 模块化和可扩展数字 : 该架构允许根据您的项目要求扩展或自定义功能.

使用实例:

使用量

地区倒计时

配置 :

  • fallbackLocales - 定义的本地人的后退.
  • defaultFallback - 默认退后。 如果没有找到更高的优先级后退,将使用它。 可用的选项 :
    • empty-string - 倒向空字符串.
    • key - 回到翻译密钥.
    • 工程使用的地方之一 allowedLocales,或者他们的名单.
  • 对于 defaultFallback empty-string 或者说 key,当一个 密钥在密钥集中缺失 转至 createMessages (那把钥匙根本没输入) 若为 defaultFallback 是本地语系或本地语系列表,缺失的密钥仍然无法解决并导致缺失翻译出错,这与存在密钥但任何倒转的本地语系中没有字符串时相同.
  • disableUseLocaleLangAsFallback - 禁用当地语言作为其倒数。 更多细节可见于倒计时搜索部分.

倒计时 locale='ru-kz'数字 :

  1. 使用 fallbackLocales['ru-kz'],如果存在
  2. 若为 disableUseLocaleLangAsFallback === false数字 :
    • 使用 内通. 语言就我们而言 Intl.Locale('ru-kz').language === 'ru'
    • 使用 allowedLocales[Intl.Locale('ru-kz').language],如果存在
    • 使用倒计时 Intl.Locale('ru-kz').language。用于搜索,从头使用同样的算法.
  3. 使用 defaultFallback

示例

列表标签

  • 使用 fallbackLocales 财务报告和审定财务报表 defaultFallback

    i18n 实例配置 :

    {
       allowedLocales: ['en', 'ru', 'ru-kz'],
       fallbackLocales: {
          'ru-kz': 'ru',
          'ru': 'en'
       },
       defaultFallback: 'empty-string'
    }
    

    按语言分类的退缩:

    • en - 空字符串
    • ru - 说吧 en空字符串
    • ru-kz - 说吧 ru, (中文(简体) ), en空字符串
  • 使用本地语言作为倒计时

    国际化实例配置 :

    {
       allowedLocales: ['en', 'ru', 'ru-kz'],
       fallbackLocales: {},
       defaultFallback: 'empty-string',
       disableUseLocaleLangAsFallback: false
    }
    

    按语言分类的退缩:

    • en, (中文(简体) ), ru - 空字符串
    • ru-kz - 说吧 ru空字符串

最终名单

版本与发布记录

@gravity-ui/i18n-core 共发布 11 个版本,首次发布于 2025/10/16;过去 12 个月发布了 9 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.6.0latest2026/04/147 个月前
1.5.02026/03/168 个月前
1.4.22026/02/139 个月前
1.4.12026/02/139 个月前
1.4.02026/02/039 个月前
1.3.22025/12/1311 个月前

关于 @gravity-ui/i18n-core 的常见问题

@gravity-ui/i18n-core 是什么?

这个 i18n- 核心数 图书馆是国际化(i18n)图书馆的基础. 建于顶上 @formatjs/intl (中文(简体) )。 。 。 .

如何安装 @gravity-ui/i18n-core?

在项目目录运行 npm install @gravity-ui/i18n-core,或使用 pnpm add / yarn add / bun add。

@gravity-ui/i18n-core 支持 TypeScript 吗?

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

@gravity-ui/i18n-core 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gravity-ui/i18n-core 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >= 18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gravity-ui/i18n-core 可以商用吗?

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

@gravity-ui/i18n-core 的下载量有多少?

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

@gravity-ui/i18n-core 还在维护吗?

最新版本 1.6.0 发布于 2026/04/14(7 个月前);至今共发布 11 个版本,其中过去 12 个月发布了 9 个;首次发布于 2025/10/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。