用户界面元素的本地化

轮播查看器显示的某些内容必须进行本地化。 此内容包括幻灯片导航按钮。

查看器中所有可以本地化的文本内容都使用名为SYMBOL的特殊Viewer SDK标识符表示。 任何SYMBOL都有英语区域设置的默认关联文本值( "en"),并且还可以根据需要为多种区域设置设置用户定义的值。

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

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

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

{
"en":{
"PanLeftButton.TOOLTIP":"Left",
"PanRightButton.TOOLTIP":"Right"
 },
 "fr":{
"PanLeftButton.TOOLTIP":"Gauchiste",
"PanRightButton .TOOLTIP":"Droit"
},
defaultLocale:"en"
}

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

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

支持以下SYMBOL:

符号

工具提示……

PlayPauseButton.TOOLTIP_SELECTED

选定的播放暂停按钮状态。

PlayPauseButton.TOOLTIP_UNSELECTED

未选择的播放暂停按钮状态。

CAROUSELEVIEWER_TOOLTIP_GOTO

上一张幻灯片按钮和下一张幻灯片按钮的工具提示和ARIA标签。

接受两个替换令牌: $CURRENT_FRAME$ 当前幻灯片索引和 $TOTAL_FRAMES$ 幻灯片总数。

Container.LABEL

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

CarouselView.ROLE_DESCRIPTION

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

CarouselView.USAGE_HINT

键盘用户的ARIA使用提示。

在此页面上