基本缩放查看器显示的某些内容需要本地化,包括缩放按钮和全屏按钮。
查看器中每个可以本地化的文本内容都由一个名为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)
方法。
支持以下符号:
符号 |
工具提示…… |
---|---|
容器.LABEL |
顶级查看器元素的ARIA标签。 |
ZoomView.ROLE_DESCRIPTION |
主视图组件的ARIA角色描述。 |
ZoomView.USAGE_HINT |
键盘用户的ARIA使用提示。 |
CloseButton.TOOLTIP |
关闭按钮。 |
ZoomInButton.TOOLTIP |
放大按钮。 |
ZoomOutButton.TOOLTIP |
缩小按钮。 |
ZoomResetButton.TOOLTIP |
缩放重置按钮。 |
FullScreenButton.TOOLTIP_SELECTED |
全屏按钮处于正常状态。 |
FullScreenButton.TOOLTIP_UNSELECTED |
全屏状态的全屏按钮。 |