Localizzazione degli elementi dell’interfaccia utente

Alcuni contenuti visualizzati nel Visualizzatore a comparsa sono soggetti a localizzazione. Questo contenuto include descrizioni comando e messaggi informativi degli elementi dell’interfaccia utente visualizzati dalla visualizzazione zoom a comparsa al momento del caricamento.

Ogni contenuto testuale nel visualizzatore che può essere localizzato è rappresentato dallo speciale identificatore SDK del visualizzatore denominato SYMBOL. Qualsiasi simbolo ha un valore di testo associato predefinito per una lingua inglese ( "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 esiste un valore definito dall'utente per ciascun SIMBOLO supportato per tali 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 è il seguente:

{
"en":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Mouse over to zoom",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Tap and hold to zoom"
 },
 "fr":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Passez la souris sur pour zoomer",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Appuyez et maintenez pour agrandir"
},
defaultLocale:"en"
}

Nell’esempio precedente, l’oggetto di localizzazione definisce due impostazioni internazionali ( "en" e "fr") e fornisce la localizzazione per due elementi dell’interfaccia utente in ciascuna lingua.

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

Sono supportati i seguenti SIMBOLI:

SIMBOLO

Descrizione

Container.LABEL

Etichetta ARIA per l’elemento visualizzatore di primo livello.

FlyoutZoomView.ROLE_DESCRIPTION

Descrizione del ruolo ARIA per il componente della vista principale.

A comparsaZoomView.USAGE_HINT

Suggerimenti per l’utilizzo di ARIA per gli utenti che utilizzano la tastiera.

A comparsaZoomView.TIP_BUBBLE_OVER

Messaggio informativo per i sistemi desktop.

A comparsaZoomView.TIP_BUBBLE_TAP

Messaggio informativo per dispositivi touch.

ScrollLeftButton.TOOLTIP

Descrizione del pulsante Scorri a sinistra.

ScrollRightButton.TOOLTIP

Descrizione del pulsante Scorri a destra.

ScrollUpButton.TOOLTIP

Descrizione del pulsante Scorri verso l'alto.

ScrollDownButton.TOOLTIP

Descrizione del pulsante di scorrimento verso il basso.

In questa pagina