Localización de elementos de la interfaz de usuario

Última actualización: 2023-11-04
  • Creado para:
  • Developer
    User

Determinado contenido que muestra el visor de catálogos electrónicos está sujeto a la localización, incluidos los botones de zoom, los botones de cambio de página, el botón de miniaturas, el botón de pantalla completa, el botón de cierre y los botones de la barra de desplazamiento.

Cada contenido textual del visualizador que se puede localizar se representa mediante un identificador especial del SDK del visualizador llamado SYMBOL. Cualquier SYMBOL tiene un valor de texto asociado por defecto para la configuración regional en inglés ( "en") se suministra con el visor predeterminado y también puede tener valores definidos por el usuario para tantas configuraciones regionales como sea necesario.

Cuando se inicia el visor, comprueba la configuración regional actual para ver si hay un valor definido por el usuario para cada SYMBOL admitido en la configuración regional. Si existe, utiliza el valor definido por el usuario; de lo contrario, vuelve al texto predeterminado predeterminado.

Los datos de localización definidos por el usuario se pueden pasar al visor como un objeto JSON de localización. Este objeto contiene la lista de configuraciones regionales admitidas, los valores de texto SYMBOL para cada configuración regional y la configuración regional predeterminada.

Un ejemplo de dicho objeto de localización:

{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
 },
 "fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}

En el ejemplo anterior, el objeto de localización define dos configuraciones regionales ( "en" y "fr") y proporciona localización para dos elementos de interfaz de usuario en cada configuración regional.

El código de la página web debe pasar dicho objeto de localización al constructor del visor como un valor de localizedTexts del objeto de configuración. Una opción alternativa es pasar el objeto de localización llamando a setLocalizedTexts(localizationInfo) método.

Se admiten los siguientes SYMBOL (suponiendo que containerId es el ID del contenedor del visor):

SIGNO

Información del objeto para...

Container.LABEL

Etiqueta ARIA para el elemento de visor de nivel superior.

PageView.ROLE_DESCRIPTION

Descripción de la función ARIA para el componente de vista principal.

PageView.USAGE_HINT

Sugerencias de uso de ARIA para usuarios de teclado.

CloseButton.TOOLTIP

Botón Cerrar.

ZoomInButton.TOOLTIP

Botón Acercar.

ZoomOutButton.TOOLTIP

Botón de alejar.

ZoomResetButton.TOOLTIP

Botón Restablecer zoom.

FullScreenButton.TOOLTIP_SELECTED

botón de pantalla completa en estado normal.

FullScreenButton.TOOLTIP_UNSELECTED

botón de pantalla completa en estado de pantalla completa.

ScrollUpButton.TOOLTIP

Botón de desplazamiento hacia arriba.

ScrollDownButton.TOOLTIP

Botón de desplazamiento hacia abajo.

<containerid>_rightButton.PanRightButton.TOOLTIP

Botón grande de página siguiente.

<containerid>_leftButton.PanLeftButton.TOOLTIP

Botón grande de la página anterior.

<containerid>_lastPageButton.PanRightButton.TOOLTIP

Botón Última página.

<containerid>_secondaryLastPageButton.PanRightButton.TOOLTIP

Botón Última página.

<containerid>_firstPageButton.PanLeftButton.TOOLTIP

Botón Primera página.

<containerid>_secondaryFirstPageButton.PanLeftButton.TOOLTIP

Botón Primera página.

<containerid>_toolBarRightButton.PanRightButton.TOOLTIP

Botón Página siguiente.

<containerid>_toolBarLeftButton.PanLeftButton.TOOLTIP

Botón Página anterior.

ThumbnailPageButton.TOOLTIP_SELECTED

Botón Miniaturas en modo de miniaturas.

ThumbnailPageButton.TOOLTIP_UNSELECTED

Botón Miniaturas en modo normal.

CloseButton.TOOLTIP

Botón Cerrar.

InfoPanelPopup.TOOLTIP_CLOSE

Botón Cerrar del panel de información.

SocialShare.TOOLTIP

Herramienta Compartir en redes sociales.

EmailShare.TOOLTIP

Botón Compartir correo electrónico.

EmailShare.HEADER

Encabezado de diálogo de correo electrónico.

EmailShare.TOOLTIP_HEADER_CLOSE

Botón de cierre superior derecho del cuadro de diálogo Correo electrónico.

EmailShare.INVALID_ADDRESS

Se muestra un mensaje de error en caso de que la dirección de correo electrónico tenga un formato incorrecto.

EmailShare.TO

Etiqueta para el campo de entrada "Hasta".

EmailShare.TOOLTIP_ADD

Botón Añadir otra dirección de correo electrónico.

EmailShare.ADD

Botón Añadir otra dirección de correo electrónico.

EmailShare.FROM

Del campo de entrada.

EmailShare.MESSAGE

Campo de entrada de mensaje.

EmailShare.TOOLTIP_REMOVE

Botón Eliminar dirección de correo electrónico.

EmailShare.CANCEL

Pie de ilustración para el botón Cancelar.

EmailShare.TOOLTIP_CANCEL

Botón Cancelar.

EmbedShare.ACTION

Pie de ilustración para el botón Seleccionar todo.

EmbedShare.TOOLTIP_ACTION

Botón Seleccionar todo.

EmailShare.CLOSE

Pie de ilustración para el botón Cerrar que se muestra en la parte inferior del cuadro de diálogo después del envío del formulario.

EmailShare.TOOLTIP_CLOSE

Botón Cerrar que se muestra en la parte inferior del cuadro de diálogo después del envío del formulario.

EmailShare.ACTION

Pie de ilustración del botón de envío del formulario.

EmailShare.TOOLTIP_ACTION

Botón de envío del formulario.

EmailShare.SEND_SUCCESS

Se muestra un mensaje de confirmación cuando el correo electrónico se ha enviado correctamente.

EmailShare.SEND_FAILURE

Mensaje de error que se muestra cuando el correo electrónico no se ha enviado correctamente.

EmbedShare.TOOLTIP

Botón Compartir incrustado.

EmbedShare.HEADER

Encabezado del cuadro de diálogo Incrustar.

EmbedShare.TOOLTIP_HEADER_CLOSE

Botón de cierre superior derecho del cuadro de diálogo Incrustar.

EmbedShare.DESCRIPTION

Descripción del texto del código incrustado.

EmbedShare.EMBED_SIZE

Etiqueta para el cuadro combinado de tamaño incrustado.

EmbedShare.CANCEL

Pie de ilustración para el botón Cancelar.

EmbedShare.TOOLTIP_CANCEL

Botón Cancelar.

EmbedShare.CUSTOM_SIZE

Texto para la última entrada de "tamaño personalizado" en el cuadro combinado de tamaño incrustado.

LinkShare.TOOLTIP

Botón Compartir vínculo.

LinkShare.HEADER

Encabezado del cuadro de diálogo Vincular.

LinkShare.TOOLTIP_HEADER_CLOSE

Botón de cierre superior derecho del cuadro de diálogo Vínculo.

LinkShare.DESCRIPTION

Descripción del vínculo compartido.

LinkShare.CANCEL

Pie de ilustración para el botón Cancelar.

LinkShare.TOOLTIP_CANCEL

Botón Cancelar.

LinkShare.ACTION

Pie de ilustración para el botón Seleccionar todo.

LinkShare.TOOLTIP_ACTION

Botón Seleccionar todo.

FacebookShare.TOOLTIP

Botón Compartir de facebook.

TwitterShare.TOOLTIP

botón Compartir en twitter.

Print.TOOLTIP

Botón Imprimir.

Print.HEADER

Encabezado del cuadro de diálogo Imprimir

Print.TOOLTIP_HEADER_CLOSE

Botón de cierre superior derecho del cuadro de diálogo Imprimir.

Print.PRINT_RANGE

Etiqueta para la sección "Seleccionar páginas de impresión".

Print.PRINT_RANGE_CURRENT

Rótulo del botón de opción "Páginas actuales".

Print.PRINT_RANGE_FROM

Rótulo para el botón de opción "Intervalo de propagación desde".

Print.PRINT_RANGE_TO

Pie de ilustración para el selector numérico "hasta".

Print.PRINT_RANGE_ALL

Pie de ilustración del botón de opción "Todas las páginas".

Print.PAGE_HANDLING

Etiqueta para la sección "Gestión de páginas".

Print.PAGE_HANDLING_ONE

Pie de ilustración del botón de opción "1 página por hoja".

Print.PAGE_HANDLING_TWO

Rótulo para el botón de opción "2 páginas por hoja".

Print.CANCEL

Pie de ilustración para el botón Cancelar.

Print.TOOLTIP_CANCEL

Botón Cancelar.

Print.ACTION

Rótulo del botón Enviar a imprimir

Print.TOOLTIP_ACTION

Botón Enviar a imprimir.

FavoritesMenu.TOOLTIP

Botón de menú Favoritos.

AddFavoriteButton.TOOLTIP_SELECTED

Botón "Agregar favorito" en el modo de edición Favoritos.

AddFavoriteButton.TOOLTIP_UNSELECTED

Botón "Agregar favorito" en modo normal.

RemoveFavoriteButton.TOOLTIP_SELECTED

Botón Eliminar favorito en el modo de edición Favoritos.

RemoveFavoriteButton.TOOLTIP_UNSELECTED

Botón "Eliminar favorito" en modo normal.

ViewAllFavoriteButton.TOOLTIP_SELECTED

Botón "Ver todos los favoritos" cuando la vista Favoritos está activa.

ViewAllFavoriteButton.TOOLTIP_UNSELECTED

Botón "Ver todos los favoritos" cuando la vista Favoritos está inactiva.

FavoritesEffect.TOOLTIP

Icono de favorito único.

MediaSet.LABEL_XX[_YY]

Etiqueta de página que genera el visor en el momento de la carga.

El nombre de ese símbolo es una plantilla, donde XX es un índice de pliego basado en cero con orientación horizontal y opcional YY es un índice de página basado en cero dentro del pliego al que se dirige XX .

Solo se aplica al recurso cargado inicialmente; se ignora si se cambia un recurso mediante setAsset() Llamada de API.

MediaSet.LABEL_DELIM

Carácter utilizado como delimitador de etiquetas de página en caso de que las etiquetas se definan para páginas izquierda y derecha dentro de un pliego.

ScrollLeftRightButton.TOOLTIP_SELECTED

Botón principal de desplazamiento de la barra de control izquierda.

ScrollLeftRightButton.TOOLTIP_UNSELECTED

Botón principal de desplazamiento de la barra de control derecha.

SearchPanel.PLACEHOLDER

Mensaje localizado que se muestra dentro del cuadro de entrada de búsqueda antes de que el usuario empiece a introducir el texto de búsqueda.

SearchPanel.INFO_PROMPT

Se muestra un mensaje localizado cuando se abre el panel de búsqueda por primera vez, sugiriendo al usuario que realice la búsqueda.

SearchPanel.INFO_NO_RESULTS

Se muestra un mensaje localizado cuando la búsqueda no arrojó ningún resultado.

Este símbolo admite el siguiente token de reemplazo en tiempo de ejecución: $SEARCH_TEXT$ . El componente lo reemplaza por el texto de búsqueda introducido por el usuario.

SearchPanel.INFO_RESULTS

Se muestra un mensaje localizado cuando la búsqueda se completa correctamente y devuelve al menos un resultado.

Este símbolo admite los siguientes tokens de reemplazo en tiempo de ejecución:

  • $SEARCH_TEXT$ : el texto de búsqueda introducido por el usuario.
  • $HIT_COUNT$ - Número total de visitas de búsqueda encontradas.
  • $PAGE_COUNT$ : el número de páginas del catálogo que contienen al menos una visita de búsqueda.

SearchPanel.THUMBNAIL_LABEL

Etiqueta localizada para la miniatura de los resultados del panel de búsqueda.

Este símbolo admite los siguientes tokens de reemplazo en tiempo de ejecución:

  • $PAGE$ - Número de página.
  • $PAGE_HIT_COUNT$ : el número de resultados de búsqueda encontrados en la página.

SearchPanel.LABEL

Define un valor de aria-label Atributo ARIA para todo el panel de búsqueda.

En esta página