文档Dynamic Media查看器参考指南

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

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员
  • 用户

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
主控件栏向右滚动按钮。
SearchPanel.PLACEHOLDER
在用户开始输入搜索文本之前，搜索输入框中显示了本地化的提示。
SearchPanel.INFO_PROMPT
首次打开搜索面板时显示的本地化消息，建议用户执行搜索。
SearchPanel.INFO_NO_RESULTS

搜索未返回任何结果时显示的本地化消息。

此符号支持以下运行时替换令牌： $SEARCH_TEXT$ 。 组件会将其替换为用户输入的搜索文本。

SearchPanel.INFO_RESULTS

搜索成功完成并返回至少一个结果时显示的本地化消息。

此符号支持以下运行时替换令牌：

  • $SEARCH_TEXT$ — 用户输入的搜索文本。
  • $HIT_COUNT$ — 找到的搜索点击总数。
  • $PAGE_COUNT$ — 至少包含一个搜索点击的目录页数。
SearchPanel.THUMBNAIL_LABEL

搜索面板的结果缩略图的本地化标签。

此符号支持以下运行时替换令牌：

  • $PAGE$ — 页码。
  • $PAGE_HIT_COUNT$ — 在页面上找到的搜索结果数。
SearchPanel.LABEL
为整个搜索面板定义 aria-label ARIA属性的值。
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8