Localisation des éléments de l’interface utilisateur

Certains contenus affichés par la visionneuse volante peuvent faire l’objet d’une localisation. Ce contenu comprend des info-bulles d’éléments de l’interface utilisateur et des messages d’informations qui s’affichent par le zoom déroulant au chargement.

Chaque contenu textuel de la visionneuse qui peut être localisé est représenté par l’identifiant spécial du SDK de la visionneuse appelé SYMBOL. Une valeur de texte associée par défaut pour un paramètre régional anglais ( "en") est fournie 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 pour ces paramètres régionaux. Si tel est le cas, elle 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. 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":{ 
"FlyoutZoomView.TIP_BUBBLE_OVER":"Mouse over to zoom", 
"FlyoutZoomView.TIP_BUBBLE_TAP":"Tap and hold to zoom" 
 }, 
 "fr":{ 
"FlyoutZoomView.TIP_BUBBLE_OVER":"Passez la souris sur pour zoomer", 
"FlyoutZoomView.TIP_BUBBLE_TAP":"Appuyez et maintenez pour 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 paramètre régional.

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

Les SYMBOLES suivants sont pris en charge :

SYMBOLE

Description

Container.LABEL

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

FlyoutZoomView.ROLE_DESCRIPTION

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

FlyoutZoomView.USAGE_HINT

Conseils d’utilisation ARIA pour les utilisateurs de clavier.

FlyoutZoomView.TIP_BUBBLE_OVER

Message d’informations pour les systèmes de bureau.

FlyoutZoomView.TIP_BUBBLE_TAP

Message d’information pour les appareils tactiles.

ScrollLeftButton.TOOLTIP

Info-bulle pour le bouton de défilement à gauche.

ScrollRightButton.TOOLTIP

Info-bulle pour le bouton droit de défilement.

ScrollUpButton.TOOLTIP

Info-bulle du bouton de défilement vers le haut.

ScrollDownButton.TOOLTIP

Info-bulle du bouton de défilement.

Sur cette page