Lokalisering av användargränssnittselement localization-of-user-interface-elements
Visst innehåll som visas i det grundläggande zoomvisningsprogrammet kan lokaliseras, inklusive zoomknappar och en helskärmsknapp.
Varje textinnehåll i visningsprogrammet som kan lokaliseras representeras av en SDK-identifierare för visningsprogrammet som kallas SYMBOL. Alla SYMBOL har ett standardassocierat textvärde för den engelska språkversionen ( "en"
) som medföljer visningsprogrammet som inte är installerat och kan även ha användardefinierade värden för så många språkområden som behövs.
När visningsprogrammet startas kontrolleras det aktuella språkområdet för att se om det finns ett användardefinierat värde för varje SYMBOL som stöds i språkområdet. Om det finns något används det användardefinierade värdet, i annat fall används standardtexten som inte finns.
Användardefinierade lokaliseringsdata kan skickas till visningsprogrammet som ett JSON-lokaliseringsobjekt. Ett sådant objekt innehåller en lista med språkområden som stöds, SYMBOL-textvärden för varje språkområde samt standardspråkområdet.
Ett exempel på ett sådant lokaliseringsobjekt:
{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
},
"fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}
I exemplet ovan definierar lokaliseringsobjektet två språkområden ( "en"
och "fr"
) och tillhandahåller lokalisering för två element i användargränssnittet i varje språkområde.
Webbsideskoden ska skicka ett sådant lokaliseringsobjekt till visningsprogramkonstruktorn som ett värde på fältet localizedTexts
i konfigurationsobjektet. Ett annat alternativ är att skicka lokaliseringsobjektet genom att anropa metoden setLocalizedTexts(localizationInfo)
.
Följande SYMBOL stöds: