用户界面元素的本地化

最近更新： 2024年7月20日
  • 主题：

创建对象：

  • 开发人员
  • 用户

eCatalog Viewer显示的某些内容需要进行本地化，这些内容包括缩放按钮、页面更改按钮、缩略图按钮、全屏按钮、关闭按钮和滚动条按钮。

查看器中的每个可本地化的文本内容都由一个名为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（假设containerId是查看器容器的ID）：

符号工具提示……
Container.LABEL顶级查看器元素的ARIA标签。
PageView.ROLE_DESCRIPTION主视图组件的ARIA角色描述。
PageView.USAGE_HINT键盘用户的ARIA使用提示。
CloseButton.TOOLTIP关闭按钮。
ZoomInButton.TOOLTIP放大按钮。
ZoomOutButton.TOOLTIP缩小按钮。
ZoomResetButton.TOOLTIP缩放重置按钮。
FullScreenButton.TOOLTIP_SELECTED全屏按钮处于正常状态。
FullScreenButton.TOOLTIP_UNSELECTED全屏按钮。
ScrollUpButton.TOOLTIP向上滚动按钮。
ScrollDownButton.TOOLTIP向下滚动按钮。
<containerId>_rightButton.PanRightButton.TOOLTIP大大的下一页按钮。
<containerId>_leftButton.PanLeftButton.TOOLTIP上一页按钮很大。
<containerId>_lastPageButton.PanRightButton.TOOLTIP“最后一页”按钮。
<containerId>_secondaryLastPageButton.PanRightButton.TOOLTIP“最后一页”按钮。
<containerId>_firstPageButton.PanLeftButton.TOOLTIP“第一页”按钮。
<containerId>_secondaryFirstPageButton.PanLeftButton.TOOLTIP“第一页”按钮。
<containerId>_toolBarRightButton.PanRightButton.TOOLTIP下一页按钮。
<containerId>_toolBarLeftButton.PanLeftButton.TOOLTIP上一页按钮。
ThumbnailPageButton.TOOLTIP_SELECTED缩略图模式中的缩略图按钮。
ThumbnailPageButton.TOOLTIP_UNSELECTED正常模式下的“缩略图”按钮。
CloseButton.TOOLTIP关闭按钮。
InfoPanelPopup.TOOLTIP_CLOSE信息面板关闭按钮。
SocialShare.TOOLTIP社交共享工具。
EmailShare.TOOLTIP电子邮件共享按钮。
EmailShare.HEADER电子邮件对话框标头。
EmailShare.TOOLTIP_HEADER_CLOSE电子邮件对话框右上角关闭按钮。
EmailShare.INVALID_ADDRESS如果电子邮件地址格式不正确，则显示错误消息。
EmailShare.TO“至”输入字段的标签。
EmailShare.TOOLTIP_ADD添加另一个电子邮件地址按钮。
EmailShare.ADD添加另一个电子邮件地址按钮。
电子邮件共享来自来自输入字段。
EmailShare.MESSAGE消息输入字段。
EmailShare.TOOLTIP_REMOVE删除电子邮件地址按钮。
EmailShare.CANCEL“取消”按钮的标题。
EmailShare.TOOLTIP_CANCEL取消按钮。
EmbedShare.ACTION“全选”按钮的标题。
EmbedShare.TOOLTIP_ACTION选择“全部”按钮。
EmailShare.CLOSE表单提交后对话框底部显示的关闭按钮的题注。
EmailShare.TOOLTIP_CLOSE表单提交后对话框底部显示的关闭按钮。
EmailShare.ACTION表单提交按钮的标题。
EmailShare.TOOLTIP_ACTION表单提交按钮。
EmailShare.SEND_SUCCESS成功发送电子邮件时显示的确认消息。
EmailShare.SEND_FAILURE电子邮件未成功发送时显示的错误消息。
EmbedShare.TOOLTIP嵌入共享按钮。
EmbedShare.HEADER嵌入对话框标头。
EmbedShare.TOOLTIP_HEADER_CLOSE嵌入对话框右上角关闭按钮。
EmbedShare.DESCRIPTION嵌入代码文本的描述。
EmbedShare.EMBED_SIZE嵌入大小组合框的标签。
EmbedShare.CANCEL“取消”按钮的标题。
EmbedShare.TOOLTIP_CANCEL取消按钮。
EmbedShare.CUSTOM_SIZE嵌入大小组合框中最后一个“自定义大小”条目的文本。
LinkShare.TOOLTIP链接共享按钮。
LinkShare.HEADER链接对话框标题。
LinkShare.TOOLTIP_HEADER_CLOSE链接对话框右上角关闭按钮。
LinkShare.DESCRIPTION共享链接的描述。
LinkShare.CANCEL“取消”按钮的标题。
LinkShare.TOOLTIP_CANCEL取消按钮。
LinkShare.ACTION“全选”按钮的标题。
LinkShare.TOOLTIP_ACTION选择“全部”按钮。
FacebookShare.TOOLTIP“Facebook共享”按钮。
TwitterShare.TOOLTIP“共享”按钮Twitter。
Print.TOOLTIP打印按钮。
Print.HEADER打印对话框标题。
Print.TOOLTIP_HEADER_CLOSE打印对话框右上角关闭按钮。
Print.PRINT_RANGE“选择打印页面”部分的标签。
Print.PRINT_RANGE_CURRENT“当前页面”单选按钮的标题。
Print.PRINT_RANGE_FROM单选按钮“扩展范围自”的标题。
Print.PRINT_RANGE_TO“至”数字选取器的标题。
Print.PRINT_RANGE_ALL“所有页面”单选按钮的标题。
Print.PAGE_HANDLING“页面处理”部分的标签。
Print.PAGE_HANDLING_ONE“每页1页”单选按钮的标题。
Print.PAGE_HANDLING_TWO“每张2页”单选按钮的标题。
打印。取消“取消”按钮的标题。
Print.TOOLTIP_CANCEL取消按钮。
打印。操作“发送以打印”按钮的标题
Print.TOOLTIP_ACTION发送以打印按钮。
FavoritesMenu.TOOLTIP收藏夹菜单按钮。
AddFavoriteButton.TOOLTIP_SELECTED编辑收藏夹模式中的“添加收藏夹”按钮。
AddFavoriteButton.TOOLTIP_UNSELECTED正常模式中的“添加收藏夹”按钮。
RemoveFavoriteButton.TOOLTIP_SELECTED编辑收藏夹模式中的“删除收藏夹”按钮。
RemoveFavoriteButton.TOOLTIP_UNSELECTED正常模式下的“删除收藏夹”按钮。
ViewAllFavoriteButton.TOOLTIP_SELECTED当收藏夹视图处于活动状态时，“查看所有收藏夹”按钮。
ViewAllFavoriteButton.TOOLTIP_UNSELECTED当收藏夹视图处于非活动状态时，“查看所有收藏夹”按钮。
FavoritesEffect.TOOLTIP单收藏夹图标。
MediaSet.LABEL_XX[_YY]

查看器在加载时生成的页面标签。

该符号的名称是一个模板，其中 XX 是横向的从零开始的跨页索引，可选 YY 是跨页内的从零开始的页索引，以 XX 为目标。

仅适用于最初加载的资产；如果使用 setAsset() API调用更改资产，则会忽略该资产。

MediaSet.LABEL_DELIM为跨页中的左页和右页定义标签时，用作页面标签分隔符的字符。
ScrollLeftRightButton.TOOLTIP_SELECTED主控件栏向左滚动按钮。
ScrollLeftRightButton.TOOLTIP_UNSELECTED主控件栏向右滚动按钮。
上一页
下一页

Experience Manager