Certains contenus que la visionneuse de catalogue électronique affiche sont sujets à localisation, notamment les boutons de zoom, les boutons de changement de page, les boutons de miniature, les boutons plein écran, les boutons de fermeture et les boutons de la barre de défilement.
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. Une valeur de texte associée par défaut pour le 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 dans les 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. 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 paramètre régional.
Le code de page web doit transmettre cet objet de localisation au constructeur de la visionneuse sous la forme d’une 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 (en supposant que containerId soit l’ID du conteneur de la visionneuse) :
SYMBOLE |
Info-bulle pour... |
---|---|
Container.LABEL |
Libellé ARIA pour l’élément de visionneuse de niveau supérieur. |
PageView.ROLE_DESCRIPTION |
Description du rôle ARIA pour le composant d’affichage principal. |
PageView.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. |
ScrollUpButton.TOOLTIP |
Bouton de défilement vers le haut. |
ScrollDownButton.TOOLTIP |
Bouton de défilement vers le bas. |
<containerid>_rightButton.PanRightButton.TOOLTIP |
Bouton Grande page suivante. |
<containerid>_leftButton.PanLeftButton.TOOLTIP |
Bouton Grande page précédente. |
<containerid>_lastPageButton.PanRightButton.TOOLTIP |
Bouton Dernière page . |
<containerid>_secondaryLastPageButton.PanRightButton.TOOLTIP |
Bouton Dernière page . |
<containerid>_firstPageButton.PanLeftButton.TOOLTIP |
Bouton Première page . |
<containerid>_secondaryFirstPageButton.PanLeftButton.TOOLTIP |
Bouton Première page . |
<containerid>_toolBarRightButton.PanRightButton.TOOLTIP |
Bouton Page suivante. |
<containerid>_toolBarLeftButton.PanLeftButton.TOOLTIP |
Bouton Page précédente . |
ThumbnailPageButton.TOOLTIP_SELECTED |
Bouton Miniatures en mode Miniatures. |
ThumbnailPageButton.TOOLTIP_UNSELECTED |
Bouton Miniatures en mode normal. |
CloseButton.TOOLTIP |
Bouton Fermer . |
InfoPanelPopup.TOOLTIP_CLOSE |
Bouton de fermeture du panneau d’informations. |
SocialShare.TOOLTIP |
Outil de partage sur les réseaux sociaux. |
EmailShare.TOOLTIP |
Bouton Partage d'email . |
EmailShare.HEADER |
En-tête de la boîte de dialogue Email. |
EmailShare.TOOLTIP_HEADER_CLOSE |
Bouton de fermeture de la boîte de dialogue Email. |
EmailShare.INVALID_ADDRESSS |
Message d’erreur affiché en cas d’erreur de l’adresse électronique. |
EmailShare.TO |
Libellé du champ de saisie "A". |
EmailShare.TOOLTIP_ADD |
Bouton Ajouter une autre adresse électronique . |
EmailShare.ADD |
Bouton Ajouter une autre adresse électronique . |
EmailShare.FROM |
Dans le champ de saisie. |
EmailShare.MESSAGE |
Champ de saisie du message. |
EmailShare.TOOLTIP_REMOVE |
Bouton Supprimer l’adresse électronique . |
EmailShare.CANCEL |
Légende du bouton Annuler. |
EmailShare.TOOLTIP_CANCEL |
Bouton Annuler . |
EmbedShare.ACTION |
Légende du bouton Tout sélectionner . |
EmbedShare.TOOLTIP_ACTION |
Bouton Tout sélectionner . |
EmailShare.CLOSE |
Légende du bouton de fermeture affiché au bas de la boîte de dialogue après l’envoi du formulaire. |
EmailShare.TOOLTIP_CLOSE |
Bouton Fermer qui s’affiche au bas de la boîte de dialogue après l’envoi du formulaire. |
EmailShare.ACTION |
Légende du bouton d’envoi du formulaire. |
EmailShare.TOOLTIP_ACTION |
Bouton d’envoi de formulaire. |
EmailShare.SEND_SUCCESS |
Message de confirmation affiché lorsque l’email a été envoyé avec succès. |
EmailShare.SEND_FAILURE |
Message d’erreur affiché lorsque l’email n’a pas été envoyé avec succès. |
EmbedShare.TOOLTIP |
Bouton Incorporer le partage . |
EmbedShare.HEADER |
Incorporer l’en-tête de la boîte de dialogue. |
EmbedShare.TOOLTIP_HEADER_CLOSE |
Bouton de fermeture de la boîte de dialogue Incorporer. |
EmbedShare.DESCRIPTION |
Description du texte du code incorporé. |
EmbedShare.EMBED_SIZE |
Libellé de la zone combinée de taille d’intégration. |
EmbedShare.CANCEL |
Légende du bouton Annuler. |
EmbedShare.TOOLTIP_CANCEL |
Bouton Annuler . |
EmbedShare.CUSTOM_SIZE |
Texte de la dernière entrée "taille personnalisée" dans la zone combinée Taille de l’intégration. |
LinkShare.TOOLTIP |
Bouton Partage de lien . |
LinkShare.HEADER |
En-tête de la boîte de dialogue Lien. |
LinkShare.TOOLTIP_HEADER_CLOSE |
Bouton de fermeture de la boîte de dialogue Lier . |
LinkShare.DESCRIPTION |
Description du lien de partage. |
LinkShare.CANCEL |
Légende du bouton Annuler. |
LinkShare.TOOLTIP_CANCEL |
Bouton Annuler . |
LinkShare.ACTION |
Légende du bouton Tout sélectionner . |
LinkShare.TOOLTIP_ACTION |
Bouton Tout sélectionner . |
FacebookShare.TOOLTIP |
Bouton Partager facebook . |
TwitterShare.TOOLTIP |
Bouton Partager twitter . |
Print.TOOLTIP |
Bouton Imprimer. |
Print.HEADER |
En-tête de la boîte de dialogue d’impression. |
Print.TOOLTIP_HEADER_CLOSE |
Bouton de fermeture de la boîte de dialogue d’impression en haut à droite. |
Print.PRINT_RANGE |
Libellé de la section "Sélectionner les pages d’impression". |
Print.PRINT_RANGE_CURRENT |
Légende du bouton radio "Pages en cours". |
Print.PRINT_RANGE_FROM |
Légende du bouton radio "Diffuser depuis". |
Print.PRINT_RANGE_TO |
Légende du sélecteur numérique "à". |
Print.PRINT_RANGE_ALL |
Légende du bouton radio "Toutes les pages". |
Print.PAGE_HANDLING |
Libellé de la section "Gestion de page". |
Print.PAGE_HANDLING_ONE |
Légende du bouton radio "1 page par feuille". |
Print.PAGE_HANDLING_DEUX |
Légende du bouton radio "2 pages par feuille". |
Print.CANCEL |
Légende du bouton Annuler. |
Print.TOOLTIP_CANCEL |
Bouton Annuler . |
Print.ACTION |
Légende du bouton Envoyer à imprimer |
Print.TOOLTIP_ACTION |
Bouton Envoyer pour impression. |
FavorisMenu.TOOLTIP |
Bouton de menu Favoris . |
AddFavoriteButton.TOOLTIP_SELECTED |
Bouton "Ajouter favori" en mode d’édition Favoris. |
AddFavoriteButton.TOOLTIP_UNSELECTED |
Bouton "Ajouter favori" en mode normal. |
RemoveFavoriteButton.TOOLTIP_SELECTED |
Bouton "Supprimer le favori" en mode de modification des favoris. |
RemoveFavoriteButton.TOOLTIP_UNSELECTED |
Bouton "Supprimer le favori" en mode normal. |
ViewAllFavoriteButton.TOOLTIP_SELECTED |
Bouton "Afficher tous les favoris" lorsque la vue Favoris est principale. |
ViewAllFavoriteButton.TOOLTIP_UNSELECTED |
Bouton "Afficher tous les favoris" lorsque la vue Favoris est inactive. |
FavorisEffect.TOOLTIP |
Icône favorite unique. |
MediaSet.LABEL_XX[_YY] |
Libellé de page généré par la visionneuse au moment du chargement. Le nom de ce symbole est un modèle, où XX est un index de dispersion de base zéro en orientation paysage, et l’option AA est un index de page de base zéro dans la diffusion ciblée par XX . s’applique uniquement à la ressource initialement chargée ; ignoré si une ressource est modifiée à l’aide de l’appel de l’API setAsset() . |
MediaSet.LABEL_DELIM |
Caractère utilisé comme délimiteur de libellés de page au cas où les libellés seraient définis pour les pages de gauche et de droite dans une propagation. |
ScrollLeftRightButton.TOOLTIP_SELECTED |
Bouton de défilement gauche de la barre de contrôle principale. |
ScrollLeftRightButton.TOOLTIP_UNSELECTED |
Bouton de défilement de la barre de contrôle principale à droite. |
SearchPanel.PLACEHOLDER |
Une invite localisée s’affiche dans la zone de saisie de la recherche avant que l’utilisateur ne commence à saisir le texte de la recherche. |
SearchPanel.INFO_PROMPT |
Message localisé affiché lors de la première ouverture du panneau de recherche, suggérant à l’utilisateur d’effectuer la recherche. |
SearchPanel.INFO_NO_RESULTS |
Message localisé affiché lorsque la recherche ne renvoyait aucun résultat. Ce symbole prend en charge le jeton de remplacement d’exécution suivant : $SEARCH_TEXT$ . Le composant le remplace par le texte de recherche saisi par l’utilisateur. |
SearchPanel.INFO_RESULTS |
Message localisé affiché lorsque la recherche est terminée et renvoie au moins un résultat. Ce symbole prend en charge les jetons de remplacement d’exécution suivants :
|
SearchPanel.THUMBNAIL_LABEL |
Libellé localisé de la miniature des résultats du panneau de recherche. Ce symbole prend en charge les jetons de remplacement d’exécution suivants :
|
SearchPanel.LABEL |
Définit une valeur de l’attribut aria-label ARIA pour l’ensemble du panneau de recherche. |