Localisation des éléments de l’interface utilisateur localization-of-user-interface-elements

Certains contenus affichés par la visionneuse de catalogue électronique sont sujets à la localisation, notamment les boutons de zoom, de changement de page, de miniature, plein écran, de fermeture et de barre de défilement.

Chaque contenu textuel de la visionneuse qui peut être localisé est représenté par un identifiant SDK de visionneuse spécial appelé SYMBOL. Tout SYMBOLE comporte une valeur de texte associée par défaut pour les paramètres régionaux anglais ( "en") fournis avec la visionneuse prête à l’emploi et peut également comporter 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 le paramètre régional en cours pour voir s’il existe une valeur définie par l’utilisateur pour chaque SYMBOLE pris en charge dans le paramètre régional. Si tel est le cas, il utilise la valeur définie par l’utilisateur ou l’utilisatrice ; dans le cas contraire, 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 le paramètre régional par défaut.

Exemple d’un tel objet de localisation :

{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
 },
 "fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
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 de l’interface utilisateur dans chaque paramètre régional.

Le code de la page web doit transmettre cet objet de localisation au constructeur de la visionneuse en tant que valeur localizedTexts champ de l’objet de configuration. Une autre option consiste à transmettre l’objet de localisation en appelant setLocalizedTexts(localizationInfo) méthode .

Les symboles suivants sont pris en charge (en supposant que containerId soit l’ID du conteneur de la visionneuse) :