Localisation des éléments de l’interface utilisateur localization-of-user-interface-elements
Certains contenus affichés par la visionneuse de carrousel sont sujets à localisation. Ce contenu comprend des boutons de navigation par diapositive.
Chaque contenu textuel de la visionneuse qui peut être localisé est représenté par l’identificateur spécial SDK de la visionneuse appelé SYMBOL. Tout SYMBOL a une valeur de texte associée par défaut pour un paramètre régional anglais ( "en"
) fourni avec la visionneuse prête à l’emploi, et peut également avoir des valeurs définies par l’utilisateur pour autant de paramètres régionaux que nécessaire.
Lorsque la visionneuse démarre, elle vérifie les paramètres régionaux actuels pour voir s’il existe une valeur définie par l’utilisateur pour chaque SYMBOLE pris en charge pour ce paramètre régional. Si c’est le cas, elle utilise la valeur définie par l’utilisateur ; Sinon, il revient au texte par défaut prêt à l’emploi.
Les données de localisation définies par l’utilisateur peuvent être transmises à la visionneuse en tant qu’objet JSON de localisation. Cet objet contient la liste des paramètres régionaux pris en charge, les valeurs de texte SYMBOL pour chaque paramètre régional et les paramètres régionaux par défaut.
Voici un exemple d’objet de localisation :
{
"en":{
"PanLeftButton.TOOLTIP":"Left",
"PanRightButton.TOOLTIP":"Right"
},
"fr":{
"PanLeftButton.TOOLTIP":"Gauchiste",
"PanRightButton .TOOLTIP":"Droit"
},
defaultLocale:"en"
}
Dans l’exemple ci-dessus, l’objet de localisation définit deux paramètres régionaux ( "en"
et "fr"
) et fournit la localisation de deux éléments d’interface utilisateur dans chaque langue.
Le code de la page Web doit transmettre l’objet de localisation au constructeur de la visionneuse, en tant que valeur de champ de localizedTexts
l’objet de configuration. Une autre option consiste à transmettre l’objet de localisation en appelant setLocalizedTexts(localizationInfo)
la méthode.
Les SYMBOLES suivants sont pris en charge :
Info-bulle et étiquette ARIA pour les boutons des diapositives précédent et suivant.
Accepte deux jetons de remplacement : $CURRENT_FRAME$ pour l’index des diapositives en cours et $TOTAL_FRAMES$ pour le nombre total de diapositives.