SuperAPI AI 工具集

i18n-date-patterns

前端与建站

查看项目

更新于 10-15 22:34

技能介绍

用途:为 React 应用提供系统化的国际化实现指导,确保所有用户可见字符串、日期显示、货币、列表和时间计算均具备本地化感知。适用场景包括:向组件添加任意用户可见文本、格式化日期/时间/货币/列表/序数、实现复杂复数、在译文中嵌入 React 组件、支持 RTL 语言(希伯来语、阿拉伯语)。

主要能力:基于 react-i18next 的 useTranslation 处理全部 UI 字符串(如 t('namespace:key'));基于集中式 useFormatting 钩子做本地化格式(formatILS 货币、formatList 列表、formatOrdinal 序数、isRTL 方向判断);基于 @/lib/dates 做日期格式化(formatDate、formatDateShort、calculateWaitTime);使用 ICU MessageFormat 处理复数(含 =0、one、other 分支及希伯来语双数、阿拉伯语类别);使用 Trans 组件在译文中嵌入 React 组件。翻译文件按命名空间拆分 JSON(如 en/common.json、he/ 同结构),支持代码分割与按功能懒加载。日期库选用 dayjs。

用法与限制:资料明确禁止硬编码字符串、用 .join() 拼列表、硬编码货币、new Date() 直接格式化、内联复数判断、在生产保留 console.log、用 dangerouslySetInnerHTML 处理 i18n。ICU 语法、区域复数类别、数字骨架、消息内日期形式、Trans 完整 API 等由上游文档负责,本技能仅保留部分内部约定(见 rules/ 与 references/ork-delta.md)。

配套资源需通过 Read("<path>") 加载:references/formatting-utilities.md、references/ork-delta.md、checklists/i18n-checklist.md、examples/component-i18n-example.md。完整标准见 docs/i18n-standards.md。技能版本 1.2.0,最后更新 2026-01-06。收费、平台支持范围等信息资料未提供。