Types
DictionaryTranslationOptions
DictionaryTranslationOptions 类型 API 参考
概览
DictionaryTranslationOptions 类型用于向字典条目传入变量，并指定其渲染行为。
它与 useTranslations 搭配使用，以向字典条目传递变量。
构建时翻译：
useTranslations 的翻译在构建时执行；但变量本身不会被翻译。
相反，变量会以格式化方式插入到译文中。
请务必遵循此部署指南。
参考资料
参数
Prop
Type
描述
| Prop | 描述 |
|---|---|
variables | 一个对象，其键用于指明每个 value 在字典 Entry 中的映射位置。 |
示例
传递变量
要向字典条目传递变量，需要完成两步：(1) 向该条目添加一个变量；(2) 在调用 d 时引用该变量。
首先，使用以下语法将变量添加到字典条目中：{username}。
username 是该变量的名称。
const dictionary = {
greeting: {
hello: '您好，{username}！',
},
};
export default dictionary;接下来，我们引用这个变量：
import { useTranslations } from 'gt-react';
const Component = () => {
const d = useTranslations();
return <div>{d('greeting.hello', { username : 'Brian123' })}</div>;
};使用 ICU 消息格式
gt-react 支持 ICU 消息格式，可用于格式化变量。
const dictionary = {
account: {
balance: '您的账户余额为：{dollars, number, ::currency/USD}！',
},
};
export default dictionary;接下来，我们引用这个变量：
import { useTranslations } from 'gt-react';
const Component = () => {
const d = useTranslations();
return <div>
{ d(
'account.balance',
{
"dollars" : 1000000,
}
) }
</div>;
};注意事项
variables对象会将值传递给字典中的 Entry。variablesOptions对象用于定义变量的行为。
后续步骤
- 参阅 dictionaries，了解字典及常见实践的更多信息。
- 参阅
useTranslations，了解字典接口的更多信息。 - 参阅
ICU 消息格式，了解更多格式化选项。
本指南如何?