7.3. 在 RHDH 中启用浮动操作按钮
您可以为浮动操作按钮启用翻译键支持,以便用户可以使用首选语言载入它。在 Developer Hub 中,所有现有和新创建的浮动操作按钮都支持使用专用转换密钥进行本地化。
Global Floating Action Button 插件通过转换键支持国际化(i18n)。您可以使用 labelKey 和 toolTipKey 属性来提供翻译密钥而不是静态文本。
该插件提供以下在 fab 命名空间下组织的内置翻译键:
-
fab.create.label- "Create" -
fab.create.tooltip- "Create entity" -
fab.docs.label- "Docs" -
fab.docs.tooltip- "Documentation" -
fab.apis.label- "API" -
fab.apis.tooltip- "API 文档" -
fab.github.label- "GitHub" -
fab.github.tooltip- "GitHub Repository" -
fab.bulkImport.label- "Bulk Import" -
fab.bulkImport.tooltip- "Register multiple repositories in bulk" -
fab.quay.label- "Quay" -
fab.quay.tooltip- "Quay Container Registry"
该插件包括以下支持的语言的翻译:
- 英语(默认)
- 法语(fr)
要在提供翻译支持时确保向后兼容性,可以使用以下顺序来解决字符串转换:
-
如果提供了
labelKey,插件将尝试解析翻译键 - 如果找到了翻译键,它将用作标签
- 如果没有找到 translation 键,插件将回退到 label 属性
注意
相同的逻辑适用于 toolTipKey 和 toolTip。
7.3.1. 内部转换实现 复制链接链接已复制到粘贴板!
复制链接链接已复制到粘贴板!
该插件使用集中式转换系统,其中:
-
在组件中调用
useTranslation ()hook,它呈现浮动操作按钮以确保正确转换上下文初始化 -
翻译功能(
t)传递到需要解析翻译密钥的子组件 - 这种内部架构可防止无限再渲染循环并确保稳定的组件渲染
-
所有使用
CustomFab的组件都必须作为 prop 提供翻译功能
注意
在扩展或修改插件组件时,请确保在父组件中调用 useTranslation () hook,并将 t prop 传递给 CustomFab 实例,以保持正确的翻译功能并防止呈现问题。