Skip to content

L10nLabel 组件

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

overview

添加组件

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

add

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

属性和说明

属性说明
StringLabel 组件内文本
不可编辑
Count变体数量
详情请参考下文
Key本地化的键值

变体数量

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

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

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

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

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

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

    dev-lang

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

    apple

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

    apple-key

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

    english

  • 翻译 界面内添加变体:

    l10nlabel/apple-variant.png

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

    result

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

key

重置键

reset

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

compile

详情请参考 语言编译

选择键

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

select