Composant Chemin de navigation (v2) breadcrumb-component
Le composant Chemin de navigation des composants principaux est un composant de navigation qui crée un chemin de navigation des liens en fonction de l’emplacement de la page dans la hiérarchie du contenu.
Utilisation usage
Le composant de chemin de navigation affiche la position de la page actuelle dans la hiérarchie du site, ce qui permet aux visiteurs de la page de parcourir la hiérarchie de celle-ci à partir de leur emplacement actuel. Cela est souvent intégré dans les en-têtes ou pieds de page.
Les options disponibles, telles que le niveau de navigation par défaut et la possibilité d’afficher la ou les pages masquées, peuvent être définies par l’auteur du modèle dans la boîte de dialogue de conception. L’éditeur de contenu peut ensuite choisir si les pages masquées doivent être affichées ou non et le niveau de navigation actuel du composant dans la boîte de dialogue de modification.
Version et compatibilité version-and-compatibility
Ce document décrit la version v2 du composant Chemin de navigation, qui a été introduite avec la version 2.0.0 des composants principaux en janvier 2018.
Exemple de sortie de composant sample-component-output
Pour tester le composant de chemin de navigation et obtenir des exemples d’options de configuration, ainsi que des sorties HTML et JSON, consultez la bibliothèque de composants.
Détails techniques technical-details
La documentation technique la plus récente sur le composant de chemin de navigation se trouve sur GitHub.
Vous trouverez plus d’informations sur le développement des composants principaux dans la documentation destinée aux développeurs de composants principaux.
Boîte de dialogue de modification edit-dialog
La boîte de dialogue de modification permet à l’auteur de contenu de supprimer les pages masquées et actives dans les chemins de navigation ainsi que la profondeur de la hiérarchie qu’elle doit afficher.
-
Niveau de départ de la navigation : à quel niveau dans la hiérarchie le composant de chemin de navigation doit commencer à descendre jusqu’à la page actuelle. Par exemple :
- 0 commence à
/content - 1 commence à
/content/<yourSite> - 2 commence à
/content/<yourSite>/<country>
- 0 commence à
-
Afficher les éléments de navigation masqués : affichez les pages marquées comme étant masquées dans le chemin de navigation (elles ne sont pas affichées par défaut).
-
Masquer la page active : supprime la page actuelle dans le chemin de navigation (par défaut, elle s’affiche).
-
Désactiver l’effet d’ombre portée : si la page de la hiérarchie est une redirection, le nom de la page de redirection s’affiche à la place de la cible. Pour plus d’informations, consultez Prise en charge de la structure de site fantôme du composant Navigation.
-
ID : cette option permet de contrôler l’identifiant unique du composant dans le code HTML ainsi que dans la couche de données.
- Si rien n’est indiqué, un ID unique est généré automatiquement et peut être trouvé en examinant la page obtenue.
- Si un ID est spécifié, il incombe à l’auteur de s’assurer qu’il est unique.
- La modification de l’ID peut avoir un impact sur le suivi CSS, JS et de couche de données.
Boîte de dialogue de conception design-dialog
La boîte de dialogue de conception permet à l’auteur du modèle de définir les valeurs par défaut des options de suppression des pages masquées et actives dans les chemins de navigation, ainsi que la profondeur de la hiérarchie qu’elle doit afficher.
Onglet Principal main-tab
-
Niveau de départ de la navigation définit la valeur par défaut à partir de laquelle le composant de chemin de navigation doit commencer à se déplacer jusqu’à la page actuelle lorsqu’il est ajouté à une page.
-
Afficher les éléments de navigation masqués : définit la valeur par défaut de l’option Afficher les éléments de navigation masqués lorsque le composant de chemin de navigation est ajouté à une page.
- Cela n’active ou ne désactive pas l’option de l’auteur. Cela définit uniquement la valeur par défaut.
-
Masquer la page active : définit la valeur par défaut de l’option Masquer la page active lorsque le composant de chemin de navigation est ajouté à une page.
- Cela n’active ou ne désactive pas l’option de l’auteur. Cela définit uniquement la valeur par défaut.
-
Désactiver l’effet d’ombre portée : définit la valeur par défaut de l’option Désactiver l’effet d’ombre portée lorsque le composant Chemin de navigation est ajouté à une page.
Onglet Styles styles-tab
Le composant de chemin de navigation prend en charge le système de style AEM.
Couche de données client Adobe data-layer
Le composant Chemin de navigation prend en charge la couche de données client Adobe.