L10nLabel 组件

L10nLabel 是可以根据内容进行定制化翻译的组件。配合文本组件使用，可对文本组件的内容进行翻译。

添加组件

用户可以在 属性检查器 上点击 添加组件 并选择 L10nLabel 来添加：

注意：L10nLabel 必须搭配 Label 组件才可以使用，如果节点上没有 Label 组件，则会自动创建一个。

属性和说明

变体数量

通过输入不同的数量，本地化会切换不同的变体。

在某些语言中，表示单数和复数会采用不同的格式，比如在英语中，一个苹果表述为：one apple，而两个苹果则会使用苹果的复数格式：two apples。为了可以在翻译后使用正确的格式，我们可以在 变体数量 内填入当前这句话内指定的物体的数量究竟是多少。

通常来说，不同语言的变体数量和当地语言有关，开发者可以向母语者进行咨询。

例如：英语有单数/复数的区别，因此在配置时变体有两种 one 和 other。某些语言如阿拉伯语有 5 种变体而俄语有 3 种变体。引擎通过适配国际规则来生成变体的数量，如果希望了解这些规则，可以参考下列地址：

• ECMAScript Internationalization API：https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules
• Unicode CLDR Project：https://cldr.unicode.org/

下面我们将通过一个详细的例子来进行说明，对于不熟悉 本地化编辑 面板的用户，可以先参考 本地化：

• 首先启用 本地化编辑，并选择中文作为开发语言：

  

• 在场景内添加一个带有 Label 组件的节点：

  

• 给这个节点添加一个 L10nLabel 的组件，并将 Key 修改为：apple-key:

  

• 添加需要翻译的语言为英语

  

• 在 翻译 界面内添加变体：

  

• 点击 本地化编辑 面板的 预览 操作，可以预览翻译后的结果，在 Count 属性中切换单数/复数时，将会显示不同的变体：

  

键

全局唯一的键，本地化会根据键不同，获取到该键在本地化中的结果。开发者可以自行输入自定义的键。也可以通过 重置 增加新的键。

重置键

如果需要新的键可以点击图示的重置按钮，此时 L10N 将会生成新的键，这些键随后也可以在 本地化编辑 中，在 编译 操作打开的面板内进行编辑：

详情请参考 语言编译

选择键

通过图示的下拉菜单可以选择已有键：