用户界面元素的本地化

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

查看器中每个可以本地化的文本内容都由名为SYMBOL的特殊查看器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)方法来传递本地化对象。

支持以下符号:

符号

工具提示……

PlayPauseButton.TOOLTIP_SELECTED

已选择播放暂停按钮状态。

PlayPauseButton.TOOLTIP_UNSELECTED

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

CAROUSELVIEWER_TOOLTIP_GOTO

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

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

容器.LABEL

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

轮播视图.ROLE_DESCRIPTION

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

轮播视图.USAGE_HINT

键盘用户的ARIA使用提示。

在此页面上