用途:在 Umbraco 后台(backoffice)扩展中实现界面文本的本地化翻译,属于基础概念类技能。
主要能力:本地化文件由 Extension Registry 管理,英语(iso 代码 'en')为回退语言;Localization Controller 在 Umbraco Elements 中通过 this.localize 自动可用,用键(key)获取翻译字符串;支持自定义翻译、带参数(动态值)翻译、函数式翻译(如复数处理)、多语言文件,以及在 manifest 中用 # 前缀引用翻译键。
使用方式:在 UmbLitElement 中调用 this.localize.term('general_close');也可使用 <umb-localize key="dialog_myKey">Default Text</umb-localize> 元素;手动场景可实例化 UmbLocalizationController。自定义翻译文件按语言各一个(如 en.js、da.js),默认导出嵌套对象,并通过 manifest 注册,type 为 'localization',meta.culture 指定语言,js 动态导入文件。带参数时用 .args 属性或 term() 第二参数;Umbraco 17.1+ 支持 termOrDefault() 提供回退文本。调试可用 debug="true" 显示键别名。
适用场景:为 Umbraco 后台扩展提供多语言界面、复用内置通用键(如 general_close、actions_create、dialog_confirm)、在 manifest 中引用翻译键。
限制:实现前应始终获取最新官方文档;回退语言固定为英语,扩展至少应包含 'en' 本地化 manifest;termOrDefault 仅 Umbraco 17.1+ 可用;资料未提供具体版本兼容范围、性能或收费信息。