TypeScript
翻译语言区域模块静态默认导出中的字面量值,同时保留周围的 TypeScript 语法。
TypeScript 语言区域模块可以将消息与描述消息的类型放在一起。typescript 文件处理器会翻译静态默认导出中的字面量值,就地替换文本,同时保留键、导入、注释以及周围的类型语法。整个过程只读取源代码,不执行模块。
为处理器提供静态消息目录 #
使用内联对象或数组作为默认导出:
export default {
checkout: {
title: "Complete your order",
retries: 3,
},
steps: ["Review", "Confirm"],
} as const;字符串单元包括 checkout.title、steps[0] 和 steps[1]。数值保持不变。as const、satisfies 以及包裹受支持表达式的括号都可以保留在源代码中。
请确保待翻译的值均为字面量。处理器不会查找导出标识符对应的声明,也不会对工厂函数调用求值。它会跳过计算属性键、展开语法、方法以及通过表达式生成的值。模板字面量只有在不含插值表达式时才受支持。如果模块有效却未生成任何翻译任务,请先检查默认导出的结构,再排查翻译是否失败。
按需保留已确认的值 #
处理器以先前的源内容为依据,按消息目录路径确定变更。对于未更改或因其他原因尚未确定的字符串,使用现有目标内容中已确认的值。锁定的路径保留当前源字面量;设为保留的路径则在已有目标值可用时保留该值。这些控制机制不会通过执行代码来查找更多文本。
替换时会沿用源字面量的引号分隔符,并据此对译文进行转义。刷新键时,会保留未选中的目标值。此次部分刷新结果中缺失的源条目可能会被移除,数组元素也不例外,因此请在加载模块前检查结果中的键及数组包含的元素。
配置文件选择 #
CLI 会将 .ts、.mts 和 .cts 识别为 typescript,但不会对 .js 或 .tsx 做出这一推断。通过 CLI 配置或 GitHub 选择语言区域模块。
加载翻译后的模块 #
此格式与 React 消息提取相互独立。消息提取会读取应用程序 .ts 和 .tsx 源代码中受支持的调用,以创建消息目录;此处理器则翻译已有结构的语言区域模块。有关这一生命周期的说明,请参阅 React 消息目录与类型。
获取模块后,请先进行类型检查,再通过应用程序的消息目录加载器加载。将选中的键与界面实际使用的消息进行对照,然后测试占位符。这些检查可以发现不同的问题:无效模块无法加载,未选中的动态值仍会保持未翻译状态,而有效的译文也可能表达错误的含义。