Lokalisatie van gebruikersinterface-elementen localization-of-user-interface-elements
Bepaalde inhoud die in de Carousel Viewer wordt weergegeven, moet worden gelokaliseerd. Deze inhoud bevat dianavigatieknoppen.
Elke tekstinhoud in de viewer die kan worden gelokaliseerd, wordt vertegenwoordigd door de speciale SDK-id van de viewer, SYMBOL genaamd. Elk SYMBOL heeft een aan de standaardwaarde gekoppelde tekstwaarde voor een Engelse landinstelling ( "en"
) die wordt geleverd met de viewer buiten de box en kan ook door de gebruiker gedefinieerde waarden hebben ingesteld voor zoveel landinstellingen als nodig.
Wanneer de viewer wordt gestart, wordt de huidige landinstelling gecontroleerd om te controleren of er voor elke ondersteunde SYMBOL-landinstelling een door de gebruiker gedefinieerde waarde is. Als dat het geval is, gebruikt het de user-defined waarde; anders, valt het terug naar de uit-van-de-doos standaardtekst.
Door de gebruiker gedefinieerde lokalisatiegegevens kunnen als JSON-lokalisatieobject worden doorgegeven aan de viewer. Dit object bevat een lijst met ondersteunde landinstellingen, SYMBOL-tekstwaarden voor elke landinstelling en de standaardlandinstelling.
Een voorbeeld van een dergelijk lokalisatieobject is het volgende:
{
"en":{
"PanLeftButton.TOOLTIP":"Left",
"PanRightButton.TOOLTIP":"Right"
},
"fr":{
"PanLeftButton.TOOLTIP":"Gauchiste",
"PanRightButton .TOOLTIP":"Droit"
},
defaultLocale:"en"
}
In het bovenstaande voorbeeld definieert het lokalisatieobject twee landinstellingen ( "en"
en "fr"
) en biedt het lokalisatie voor twee gebruikersinterface-elementen in elke landinstelling.
De webpaginacode moet het lokalisatieobject doorgeven aan de viewerconstructor als een waarde van het localizedTexts
-veld van het configuratieobject. Een andere optie is om het lokalisatieobject door te geven door de methode setLocalizedTexts(localizationInfo)
aan te roepen.
De volgende SYMBOL's worden ondersteund:
Knopinfo en ARIA-label voor vorige en volgende diaknoppen.
Accepteert twee vervangingstokens: $CURRENT_FRAME$ voor de huidige dia-index en $TOTAL_FRAMES$ voor het totale aantal dia's.