Lokalisatie van gebruikersinterface-elementen localization-of-user-interface-elements
Bepaalde inhoud die in de Interactive Image Viewer wordt weergegeven, is afhankelijk van lokalisatie. Deze inhoud bevat knopinfo voor gebruikersinterface-elementen en een informatiebericht dat tijdens het laden wordt weergegeven in de zoomweergave voor vervolgmenu's.
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 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":{
"Container.LABEL":"Interactive Image Viewer"
},
"fr":{
"Container.LABEL":"Visionneuse d'images interactive"
},
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: