用户界面元素的本地化

上次更新: 2023-11-04
  • 创建对象:
  • Developer
    User

基本缩放查看器显示的某些内容需要进行本地化,包括缩放按钮和全屏按钮。

查看器中的每个可本地化的文本内容都由一个名为SYMBOL的特殊查看器SDK标识符表示。 任何SYMBOL都具有英语语言环境( "en"),并且还可以根据需要为多种区域设置设置用户定义的值。

当查看器启动时,它会检查当前区域设置,查看区域设置中每个受支持的SYMBOL是否存在用户定义的值。 如果存在,则使用用户定义的值;否则,它会回退到现成的默认文本。

用户定义的本地化数据可以作为本地化JSON对象传递给查看器。 此类对象包含支持的区域设置列表、每个区域设置的SYMBOL文本值以及默认区域设置。

此类本地化对象的示例:

{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
 },
 "fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}

在上述示例中,本地化对象定义了两个区域设置( "en""fr"),并为每个区域设置中的两个用户界面元素提供本地化。

网页代码应将此类本地化对象作为的值传递给查看器构造函数 localizedTexts 配置对象的字段。 另一种选择是通过调用传递本地化对象。 setLocalizedTexts(localizationInfo) 方法。

支持以下SYMBOL:

符号

的工具提示……

Container.LABEL

顶级查看器元素的ARIA标签。

ZoomView.ROLE_DESCRIPTION

主视图组件的ARIA角色描述。

ZoomView.USAGE_HINT

键盘用户的ARIA使用提示。

CloseButton.TOOLTIP

关闭按钮。

ZoomInButton.TOOLTIP

放大按钮。

ZoomOutButton.TOOLTIP

缩小按钮。

ZoomResetButton.TOOLTIP

缩放重置按钮。

FullScreenButton.TOOLTIP_SELECTED

全屏按钮处于正常状态。

FullScreenButton.TOOLTIP_UNSELECTED

全屏按钮。

在此页面上