Le contenu affiché par la visionneuse de zoom de base est sujet à localisation, notamment les boutons de zoom et un bouton plein écran.
Chaque contenu textuel de la visionneuse qui peut être localisé est représenté par un identifiant SDK de visionneuse spécial appelé SYMBOL. Tout SYMBOL est associé par défaut à une valeur de texte pour la langue anglaise ( "en"
) fournie avec le lecteur prêt à l’emploi et peut également avoir des valeurs définies par l’utilisateur pour autant de paramètres régionaux que nécessaire.
Lorsque le lecteur de contenu début, il vérifie les paramètres régionaux actuels pour 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, 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 au lecteur sous la forme d’un 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 localisation définit deux paramètres régionaux ( "en"
et "fr"
) et fournit la localisation de deux éléments d’interface utilisateur dans chaque paramètre régional.
Le code de page Web doit transmettre cet objet de localisation au constructeur du lecteur de contenu sous la forme d’un 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 |
Info-bulle pour... |
---|---|
Conteneur.LABEL |
Libellé ARIA pour l’élément de lecteur de niveau supérieur. |
ZoomView.ROLE_DESCRIPTION |
Description du rôle ARIA pour le composant principal de la vue. |
ZoomView.USAGE_HINT |
Conseils d’utilisation ARIA pour les utilisateurs du clavier. |
CloseButton.TOOLTIP |
Bouton Fermer. |
ZoomInButton.TOOLTIP |
Bouton Zoom avant. |
ZoomOutButton.TOOLTIP |
Bouton Zoom arrière. |
ZoomResetButton.TOOLTIP |
Bouton de réinitialisation de zoom. |
FullScreenButton.TOOLTIP_SELECTED |
Bouton plein écran en état normal. |
FullScreenButton.TOOLTIP_UNSELECTED |
Bouton plein écran en mode plein écran. |