用户界面元素的本地化

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):

符号

工具提示……

容器.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_ADDRESSS

电子邮件地址格式错误时显示错误消息。

EmailShare.TO

“To”输入字段的标签。

EmailShare.TOOLTIP_ADD

添加其他电子邮件地址按钮。

EmailShare.ADD

添加其他电子邮件地址按钮。

EmailShare.FROM

从输入字段。

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

“to”数字选取器的说明。

Print.PRINT_RANGE_ALL

“所有页面”单选按钮的描述。

PRINT.PAGE_HANDLING

“页面处理”部分的标签。

Print.PAGE_HANDLING_ONE

“每页1页”单选按钮的描述。

Print.PAGE_HANDLING_TWO

“每页2页”单选按钮的描述。

打印。取消

“取消”按钮的说明。

Print.TOOLTIP_CANCEL

“取消”按钮。

PRINT.ACTION

“发送到打印”按钮的描述

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属性的值。

在此页面上