Localizzazione degli elementi dell’interfaccia utente localization-of-user-interface-elements

Alcuni contenuti visualizzati dal visualizzatore eCatalog sono soggetti a localizzazione, ad esempio i pulsanti di zoom, i pulsanti di modifica della pagina, i pulsanti delle miniature, i pulsanti a schermo intero, i pulsanti di chiusura e i pulsanti della barra di scorrimento.

Ogni contenuto testuale nel visualizzatore che può essere localizzato è rappresentato da uno speciale identificatore SDK del visualizzatore chiamato SYMBOL. Qualsiasi simbolo ha un valore di testo associato predefinito per le impostazioni locali inglesi ( "en") fornito con il visualizzatore predefinito e può anche avere valori definiti dall'utente impostati per tutte le impostazioni internazionali necessarie.

All'avvio, il visualizzatore controlla le impostazioni locali correnti per verificare se è presente un valore definito dall'utente per ciascun SIMBOLO supportato nelle impostazioni locali. In caso affermativo, viene utilizzato il valore definito dall’utente; in caso contrario, viene utilizzato il testo predefinito.

I dati di localizzazione definiti dall’utente possono essere trasmessi al visualizzatore come oggetto JSON di localizzazione. Tale oggetto contiene l'elenco delle impostazioni locali supportate, i valori di testo SYMBOL per ciascuna impostazione locale e le impostazioni locali predefinite.

Un esempio di tale oggetto di localizzazione:

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

Nell'esempio precedente, l'oggetto di localizzazione definisce due impostazioni locali ( "en" e "fr") e fornisce la localizzazione per due elementi dell'interfaccia utente in ciascuna impostazione locale.

Il codice della pagina Web deve trasmettere tale oggetto di localizzazione al costruttore del visualizzatore come valore del campo localizedTexts dell'oggetto di configurazione. In alternativa, passare l'oggetto di localizzazione chiamando il metodo setLocalizedTexts(localizationInfo).

Sono supportati i seguenti SIMBOLI (supponendo che containerId sia l’ID del contenitore del visualizzatore):

SIMBOLO
Descrizione comando per...
Container.LABEL
Etichetta ARIA per l’elemento visualizzatore di primo livello.
PageView.ROLE_DESCRIPTION
Descrizione del ruolo ARIA del componente della vista principale.
PageView.USAGE_HINT
Suggerimenti per l’utilizzo di ARIA per gli utenti che utilizzano la tastiera.
CloseButton.TOOLTIP
Pulsante Chiudi.
ZoomInButton.TOOLTIP
Pulsante Zoom in.
ZoomOutButton.TOOLTIP
Pulsante Zoom out.
ZoomResetButton.TOOLTIP
Pulsante di ripristino zoom.
FullScreenButton.TOOLTIP_SELECTED
pulsante a schermo intero in stato normale.
FullScreenButton.TOOLTIP_UNSELECTED
pulsante di visualizzazione a schermo intero.
ScrollUpButton.TOOLTIP
Pulsante Scorri in alto.
ScrollDownButton.TOOLTIP
Pulsante Scorri verso il basso.
<containerId>_rightButton.PanRightButton.TOOLTIP
Pulsante Pagina successiva grande.
<containerId>_leftButton.PanLeftButton.TOOLTIP
Pulsante Pagina precedente grande.
<containerId>_lastPageButton.PanRightButton.TOOLTIP
Pulsante Ultima pagina
<containerId>_secondaryLastPageButton.PanRightButton.TOOLTIP
Pulsante Ultima pagina
<containerId>_firstPageButton.PanLeftButton.TOOLTIP
Pulsante Prima pagina
<containerId>_secondaryFirstPageButton.PanLeftButton.TOOLTIP
Pulsante Prima pagina
<containerId>_toolBarRightButton.PanRightButton.TOOLTIP
Pulsante Pagina successiva.
<containerId>_toolBarLeftButton.PanLeftButton.TOOLTIP
Pulsante Pagina precedente.
ThumbnailPageButton.TOOLTIP_SELECTED
Pulsante Miniature in modalità miniature.
ThumbnailPageButton.TOOLTIP_UNSELECTED
Pulsante Miniature in modalità normale.
CloseButton.TOOLTIP
Pulsante Chiudi.
InfoPanelPopup.TOOLTIP_CLOSE
Pulsante di chiusura del pannello Info.
SocialShare.TOOLTIP
Strumento di condivisione social.
EmailShare.TOOLTIP
Pulsante Condivisione e-mail.
EmailShare.HEADER
Intestazione della finestra di dialogo e-mail.
EmailShare.TOOLTIP_HEADER_CLOSE
Pulsante di chiusura in alto a destra della finestra di dialogo E-mail.
EmailShare.INVALID_ADDRESSS
Messaggio di errore visualizzato nel caso in cui l’indirizzo e-mail non sia corretto.
Condivisione e-mail .TO
Etichetta per il campo di input "A".
EmailShare.TOOLTIP_ADD
Pulsante Aggiungi un altro indirizzo e-mail.
Condivisione e-mail.AGGIUNGI
Pulsante Aggiungi un altro indirizzo e-mail.
Condivisione e-mail .DA
Dal campo di input.
Condivisione e-mail.MESSAGGIO
Campo di input del messaggio.
EmailShare.TOOLTIP_REMOVE
Rimuovi il pulsante Indirizzo e-mail.
Condivisione e-mail.ANNULLA
Didascalia del pulsante Annulla.
EmailShare.TOOLTIP_CANCEL
pulsante Annulla.
EmbedShare.ACTION
Didascalia del pulsante Seleziona tutto.
EmbedShare.TOOLTIP_ACTION
Seleziona il pulsante Tutto.
Condivisione e-mail.CHIUDI
Didascalia del pulsante Chiudi visualizzata nella parte inferiore della finestra di dialogo dopo l’invio del modulo.
EmailShare.TOOLTIP_CLOSE
Pulsante Chiudi visualizzato nella parte inferiore della finestra di dialogo dopo l’invio del modulo.
EmailShare.ACTION
Didascalia del pulsante di invio del modulo.
EmailShare.TOOLTIP_ACTION
Pulsante Invio modulo.
Condivisione e-mail.SEND_SUCCESS
Messaggio di conferma visualizzato quando l’e-mail è stata inviata correttamente.
EmailShare.SEND_FAILURE
Messaggio di errore visualizzato quando l’e-mail non è stata inviata correttamente.
EmbedShare.TOOLTIP
Pulsante Incorpora condivisione.
EmbedShare.HEADER
Incorpora intestazione finestra di dialogo.
IncorporaShare.TOOLTIP_HEADER_CLOSE
Pulsante Chiudi in alto a destra nella finestra di dialogo Incorpora.
EmbedShare.DESCRIPTION
Descrizione del testo del codice di incorporamento.
EmbedShare.EMBED_SIZE
Etichetta per la casella combinata dimensione incorporamento.
CondivisioneIncorporata.ANNULLA
Didascalia del pulsante Annulla.
EmbedShare.TOOLTIP_CANCEL
pulsante Annulla.
EmbedShare.CUSTOM_SIZE
Testo per l'ultima voce "custom size" (dimensione personalizzata) nella casella combinata embed size (dimensione incorporata).
LinkShare.TOOLTIP
Pulsante Condivisione collegamento.
LinkShare.HEADER
Intestazione della finestra di dialogo Collega.
LinkShare.TOOLTIP_HEADER_CLOSE
Pulsante di chiusura in alto a destra della finestra di dialogo Collega.
LinkShare.DESCRIPTION
Descrizione del collegamento di condivisione.
LinkShare.ANNULLA
Didascalia del pulsante Annulla.
LinkShare.TOOLTIP_CANCEL
pulsante Annulla.
LinkShare.ACTION
Didascalia del pulsante Seleziona tutto.
LinkShare.TOOLTIP_ACTION
Seleziona il pulsante Tutto.
FacebookShare.TOOLTIP
Pulsante Condividi di facebook.
TwitterShare.TOOLTIP
Pulsante Condivisione twitter.
Print.TOOLTIP
Pulsante Stampa
Print.HEADER
Intestazione della finestra di dialogo Stampa.
Stampa.TOOLTIP_HEADER_CHIUDI
Finestra di dialogo Stampa pulsante di chiusura superiore destro.
Print.PRINT_RANGE
Etichetta per la sezione "Seleziona pagine di stampa".
Stampa.PRINT_RANGE_CURRENT
Didascalia del pulsante di opzione "Pagine correnti".
Print.PRINT_RANGE_FROM
Didascalia del pulsante di opzione "Distribuisci intervallo da".
Print.PRINT_RANGE_TO
Didascalia del selettore numerico "a".
Print.PRINT_RANGE_ALL
Didascalia del pulsante di opzione "Tutte le pagine".
Gestione stampa.PAGINE
Etichetta per la sezione "Gestione pagine".
Print.PAGE_HANDLING_ONE
Didascalia del pulsante di opzione "1 pagina per foglio".
Print.PAGE_HANDLING_TWO
Didascalia del pulsante di opzione "2 pagine per foglio".
Stampa.ANNULLA
Didascalia del pulsante Annulla.
Stampa.TOOLTIP_CANCEL
pulsante Annulla.
Print.ACTION
Didascalia del pulsante Invia a stampa
Print.TOOLTIP_ACTION
Pulsante Invia a stampa.
PreferitiMenu.TOOLTIP
Pulsante del menu Preferiti.
AddFavoriteButton.TOOLTIP_SELECTED
Pulsante "Aggiungi preferiti" nella modalità di modifica Preferiti.
AddFavoriteButton.TOOLTIP_UNSELECTED
Pulsante "Aggiungi preferiti" in modalità normale.
RemoveFavoriteButton.TOOLTIP_SELECTED
Pulsante "Rimuovi preferiti" nella modalità di modifica Preferiti.
RemoveFavoriteButton.TOOLTIP_UNSELECTED
Pulsante Rimuovi preferiti in modalità normale.
VisualizzaTuttoPulsantePreferito.SUGGERIMENTO_SELEZIONATO
Pulsante "Visualizza tutti i preferiti" quando la visualizzazione Preferiti è attiva.
VisualizzaTuttoPulsantePreferito.SUGGERIMENTO_NON SELEZIONATO
Pulsante Visualizza tutti i preferiti quando la visualizzazione Preferiti non è attiva.
PreferitesEffect.TOOLTIP
Singola icona preferita.
MediaSet.LABEL_XX[_AA]

Etichetta di pagina generata dal visualizzatore al momento del caricamento.

Il nome del simbolo è un modello, dove XX è un indice di distribuzione a base zero con orientamento orizzontale e YY facoltativo è un indice di pagina a base zero all'interno della distribuzione di destinazione XX .

Si applica solo alla risorsa caricata inizialmente. Viene ignorato se una risorsa viene modificata tramite la chiamata API setAsset() .

MediaSet.LABEL_DELIM
Carattere utilizzato come delimitatore di etichette di pagina se le etichette sono definite per le pagine a sinistra e a destra all’interno di un set affiancato.
ScrollLeftRightButton.TOOLTIP_SELECTED
Pulsante di scorrimento a sinistra della barra dei controlli principale.
ScrollLeftRightButton.TOOLTIP_UNSELECTED
Pulsante Scorri a destra nella barra dei controlli principale.
SearchPanel.PLACEHOLDER
Viene visualizzato un prompt localizzato all'interno della casella di input della ricerca prima che l'utente inizi a immettere il testo da cercare.
SearchPanel.INFO_PROMPT
Messaggio localizzato visualizzato quando il pannello di ricerca viene aperto per la prima volta, che suggerisce all’utente di eseguire la ricerca.
SearchPanel.INFO_NO_RESULTS

Messaggio localizzato visualizzato quando la ricerca non ha restituito alcun risultato.

Questo simbolo supporta il seguente token di sostituzione runtime: $SEARCH_TEXT$ . Il componente lo sostituisce con il testo di ricerca immesso dall’utente.

SearchPanel.INFO_RESULTS

Messaggio localizzato visualizzato quando la ricerca è completata correttamente e restituisce almeno un risultato.

Questo simbolo supporta i seguenti token di sostituzione runtime:

  • $SEARCH_TEXT$ : testo di ricerca immesso dall'utente.
  • $HIT_COUNT$ - Numero totale di risultati di ricerca trovati.
  • $PAGE_COUNT$ - Numero di pagine di catalogo contenenti almeno un risultato di ricerca.
SearchPanel.THUMBNAIL_LABEL

Etichetta localizzata per la miniatura dei risultati del pannello di ricerca.

Questo simbolo supporta i seguenti token di sostituzione runtime:

  • $PAGE$ - Numero pagina.
  • $PAGE_HIT_COUNT$ - Numero di risultati di ricerca trovati nella pagina.
SearchPanel.LABEL
Definisce un valore dell'attributo aria-label di per l'intero pannello di ricerca.
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8