Localisation des éléments de l’interface utilisateur

Dernière mise à jour : 2023-11-04
  • Créé pour :
  • Developer
    User

Certains contenus affichés par la visionneuse de zoom de base peuvent être localisés, notamment des boutons de zoom et un bouton plein écran.

Chaque contenu textuel de la visionneuse qui peut être localisé est représenté par un identifiant spécial du SDK de la visionneuse appelé SYMBOL. Tout SYMBOL est associé par défaut à une valeur de texte pour le 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 afin de déterminer s’il existe une valeur définie par l’utilisateur pour chaque SYMBOL pris en charge dans les paramètres régionaux. Si tel est le cas, il utilise la valeur définie par l’utilisateur ; dans le cas contraire, il revient au texte par défaut d’usine.

Les données de localisation définies par l’utilisateur peuvent être transmises à la visionneuse en tant qu’objet JSON de localisation. Un tel 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.

Exemple d’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 permet de localiser deux éléments de l’interface utilisateur dans chaque langue.

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

Les SYMBOLES suivants sont pris en charge :

SYMBOLE

Info-bulle pour...

Container.LABEL

Libellé ARIA pour l’élément de visionneuse de niveau supérieur.

ZoomView.ROLE_DESCRIPTION

Description du rôle ARIA pour le composant d’affichage principal.

ZoomView.USAGE_HINT

Conseils d’utilisation ARIA pour les utilisateurs de clavier.

CloseButton.TOOLTIP

Bouton Fermer .

ZoomInButton.TOOLTIP

Bouton Zoom avant.

ZoomOutButton.TOOLTIP

Bouton Zoom arrière.

ZoomResetButton.TOOLTIP

Bouton Réinitialiser le zoom .

FullScreenButton.TOOLTIP_SELECTED

bouton plein écran en état normal.

FullScreenButton.TOOLTIP_UNSELECTED

bouton plein écran en mode plein écran.

Sur cette page