用户界面元素的本地化

弹出查看器显示的某些内容需要本地化。 此内容包括用户界面元素工具提示和信息消息,这些消息在加载时通过弹出缩放视图显示。

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

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

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

此类本地化对象的示例如下:

{
"en":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Mouse over to zoom",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Tap and hold to zoom"
 },
 "fr":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Passez la souris sur pour zoomer",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Appuyez et maintenez pour agrandir"
},
defaultLocale:"en"
}

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

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

支持以下符号:

符号

说明

容器.LABEL

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

FlyoutZoomView.ROLE_DESCRIPTION

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

FlyoutZoomView.USAGE_HINT

键盘用户的ARIA使用提示。

FlyoutZoomView.TIP_BUBBLE_OVER

桌面系统的信息消息。

FlyoutZoomView.TIP_BUBBLE_TAP

触控设备的信息消息。

ScrollLeftButton.TOOLTIP

滚动左键的工具提示。

ScrollRightButton.TOOLTIP

滚动右键的工具提示。

ScrollUpButton.TOOLTIP

“向上滚动”按钮的工具提示。

ScrollDownButton.TOOLTIP

向下滚动按钮的工具提示。

在此页面上