用户界面元素的本地化 localization-of-user-interface-elements

混合媒体查看器显示的某些内容需要进行本地化。 此准则包括缩放按钮、旋转按钮、视频控件、关闭按钮、全屏按钮和样本滚动按钮。

查看器中的每个可本地化的文本内容都由一个名为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使用提示。
SpinView.ROLE_DESCRIPTION
主视图组件的ARIA角色描述。
SpinView.USAGE_HINT
键盘用户的ARIA使用提示。
FlyoutZoomView.ROLE_DESCRIPTION
主视图组件的ARIA角色描述。
FlyoutZoomView.USAGE_HINT
键盘用户的ARIA使用提示。
CloseButton.TOOLTIP
关闭按钮。
ZoomInButton.TOOLTIP
放大按钮。
ZoomOutButton.TOOLTIP
缩小按钮。
ZoomResetButton.TOOLTIP
缩放重置按钮。
FlyoutZoomView.TIP_BUBBLE_OVER
桌面系统处于内联缩放模式。
FlyoutZoomView.TIP_BUBBLE_TAP
触控设备处于内联缩放模式。
FullScreenButton.TOOLTIP_SELECTED
全屏按钮处于正常状态。
FullScreenButton.TOOLTIP_UNSELECTED
全屏按钮。
ClosedCaptionButton.TOOLTIP_SELECTED
选定的隐藏式字幕按钮状态。
ClosedCaptionButton.TOOLTIP_UNSELECTED
未选择隐藏式字幕按钮状态。
ScrollLeftButton.TOOLTIP
向左滚动按钮。
ScrollRightButton.TOOLTIP
向右滚动按钮。
ScrollUpButton.TOOLTIP
向上滚动按钮。
ScrollDownButton.TOOLTIP
向下滚动按钮。
PanLeftButton.TOOLTIP
旋转左侧按钮。
PanRightButton.TOOLTIP
向右旋转按钮。
PlayPauseButton.TOOLTIP_SELECTED
已选择播放暂停按钮状态。
PlayPauseButton.TOOLTIP_UNSELECTED
已取消选择播放暂停按钮状态。
PlayPauseButton.TOOLTIP_REPLAY
播放暂停按钮状态。
VideoScrubber.TOOLTIP
视频洗刷。
VideoTime.TOOLTIP
控制栏上的视频时间。
MutableVolume.TOOLTIP_SELECTED
选定的可变卷状态。
MutableVolume.TOOLTIP_UNSELECTED
已取消选择可变卷。
MutableVolume.TOOLTIP_VOLUME
通过ARIA aria-valuetext 属性公开的卷滑块旋钮标签。
VideoPlayer.错误
无法播放视频时显示的错误消息。
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8