Lokalisering av användargränssnittselement localization-of-user-interface-elements
Visst innehåll som visas i visningsprogrammet för blandade media kan lokaliseras. Den här riktlinjen innehåller zoomknappar, rotationsknappar, videokontroller, stängningsknappar, helskärmsknappar och rullningsknappar för färgrutor.
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 engelska ( "en"
) medföljer det färdiga visningsprogrammet. Den kan också 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 för 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. Det här objektet 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 är följande:
{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
},
"fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}
I ovanstående exempel definierar lokaliseringsobjektet två språkinställningar ( "en"
och "fr"
) och tillhandahåller lokalisering för två element i användargränssnittet i varje språkområde.
Webbsideskoden ska skicka lokaliseringsobjektet till visningsprogramkonstruktorn som ett värde för localizedTexts
konfigurationsobjektets fält. Ett annat alternativ är att skicka lokaliseringsobjektet genom att anropa setLocalizedTexts(localizationInfo)
-metod.
Följande SYMBOL stöds: