SuperAPI AI 工具集

internationalization-i18n

通用与其它

查看项目

更新于 10-15 21:04

技能介绍

用途:为应用实现国际化(i18n),管理多语言翻译、格式化与从右到左(RTL)布局。

主要能力:

  • i18next 集成(React):通过 i18next、react-i18next 与 i18next-browser-languagedetector 初始化,配置 fallbackLng、interpolation 与 resources,使用 useTranslation 的 t 函数取词。
  • 复数处理:翻译文件中用 items、items_plural、items_zero 等键,调用 t('items', { count }) 按数量返回对应文案。
  • 日期与数字格式化:使用 Intl.DateTimeFormat 格式化日期,Intl.NumberFormat 格式化货币与数字,Intl.RelativeTimeFormat 输出相对时间。
  • RTL 支持:CSS 使用逻辑属性如 margin-inline-start、padding-inline-end,配合 html[dir="rtl"] 调整图标方向。
  • 其他框架:参考资料 references/frameworks.md 涵盖 React-Intl(Format.js)、Python gettext 与 Flask/Babel、RTL 模式及 ICU Message Format 示例。

使用方式:按上述方式初始化 i18n 实例并配置语言资源,在组件中通过 t 函数取翻译文本;格式化使用 Intl API;RTL 通过逻辑属性与 dir 属性实现。

适用场景:需要多语言界面、复数规则、本地化日期/数字/货币及 RTL 语言支持的前端或全栈应用。

限制与最佳实践:提取所有面向用户的字符串;复杂翻译使用 ICU 消息格式;用伪本地化测试;从一开始支持 RTL;不要拼接已翻译字符串;生产环境使用专业译者。具体安装命令与完整代码示例资料中未提供。