Composant Onglets

Le composant Onglets des composants principaux permet l’organisation de contenu sur plusieurs onglets.

Utilisation

Le composant Onglets permet à l’auteur de contenu d’organiser le contenu de la page dans plusieurs onglets.

La boîte de dialogue de modification permet à l’auteur de contenu de définir plusieurs onglets et de définir l’onglet actif. À l’aide de la boîte de dialogue de conception, l’auteur du modèle peut définir les composants qui peuvent être ajoutés aux onglets et personnaliser les styles.

TIP

Les composants d’onglets imbriqués (onglets dans les onglets) sont pris en charge.

Les composants des onglets simples (non imbriqués) peuvent être localisés/sélectionnés à l’aide de l’arborescence de contenu, mais les onglets imbriqués ne peuvent pas l’être.

Liaison profonde vers un panneau

Les composants Onglets et Accordéon prennent en charge la liaison directe à un panneau au sein du composant.

Pour ce faire :

  1. Affichez la page avec le composant à l’aide de l’option Afficher comme publié(e) dans l’éditeur de page.
  2. Examinez le contenu de la page et identifiez l’ID du panneau.
    • Par exemple, id="accordion-86196c94d3-item-ca319dbb0b"
  3. L’ID devient l’ancre que vous pouvez ajouter à l’URL à l’aide d’un hachage (#).
    • Par exemple, https://wknd.site/content/wknd/language-masters/en/magazine/western-australia.html#accordion-86196c94d3-item-ca319dbb0b

En accédant à l’URL avec l’ID de panneau comme ancre, le navigateur fait défiler directement le composant et affiche le panneau spécifié. Si le panneau est configuré pour ne pas être développé par défaut, il sera développé automatiquement.

Version et compatibilité

La version actuelle du composant Onglets est v1, qui a été introduite avec la version 2.2.0 des composants principaux d’octobre 2018. Elle est décrite dans ce document.

Le tableau ci-après présente en détail toutes les versions prises en charge du composant, les versions AEM avec lesquelles les versions du composant sont compatibles et les liens vers la documentation pour les versions précédentes.

Version du composant AEM 6.4 AEM 6.5 AEM as a Cloud Service
v1 Compatible Compatible Compatible

Pour plus d’informations sur les versions et les publications des composants principaux, voir le document sur les versions des composants principaux.

Exemple de sortie de composant

Pour tester le composant Onglets, des exemples d’options de configuration, ainsi que des sorties HTML et JSON, consultez la Bibliothèque de composants.

Détails techniques

La documentation technique la plus récente sur le composant Onglets 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

La boîte de dialogue de modification permet à l’auteur de contenu de créer, renommer et réorganiser les onglets et de définir l’onglet actif.

Onglet Éléments

Onglet Éléments de la boîte de dialogue de modification du composant Onglets

Utilisez le bouton Ajouter pour ouvrir le sélecteur de composants afin de choisir le composant à ajouter sous forme d’onglet. Une fois le composant ajouté, une entrée est ajoutée à la liste qui contient les colonnes suivantes :

  • Icône : icône du type de composant de l’onglet pour une identification facile dans la liste. Pointez dessus pour afficher le nom complet du composant sous forme d’info-bulle.
  • Description : description utilisée comme texte de l’onglet. Par défaut, il s’agit du nom du composant sélectionné pour l’onglet.
  • Supprimer : appuyez ou cliquez dessus pour supprimer l’onglet du composant Onglets.
  • Réorganiser : appuyez ou cliquez dessus et faites glisser pour réorganiser l’ordre des onglets.
TIP

Si la fenêtre d’affichage de la page est réduite, de sorte que la boîte de dialogue de modification s’affiche en plein écran, le bouton Ajouter est masqué. Vous pouvez toujours ajouter des composants au composant Onglets en les faisant glisser depuis l’explorateur de composants et en les déposant ensuite sur le composant Onglets dans l’éditeur de page.

Onglet Propriétés

Onglet Propriétés de la boîte de dialogue de modification du composant Onglets

  • Élément actif : l’auteur du contenu peut définir quel onglet est actif lorsque la page est chargée.
    • Avec l’option Par défaut, le premier onglet est sélectionné.
  • 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.

Onglet Accessibilité

Onglet Accessibilité de la boîte de dialogue de modification du composant Onglets

Dans l’onglet Accessibilité, les valeurs peuvent être définies pour les libellés d’accessibilité ARIA du composant.

  • Libellé - Valeur d’un attribut de libellé ARIA pour le composant

Sélectionner un panneau

L’auteur du contenu peut utiliser l’option Sélectionner un panneau la barre d’outils du composant pour choisir un panneau différent, ainsi que pour réorganiser l’ordre des onglets.

Icône Sélectionner un panneau

Lorsque vous sélectionnez l’option Sélectionner un panneau dans la barre d’outils du composant, les onglets configurés s’affichent sous forme de liste déroulante.

  • La liste est classée en fonction de la disposition des onglets et est reflétée dans la numérotation.
  • Le type de composant de l’onglet est affiché en premier, suivi de la description de l’onglet une police plus claire.

Fenêtre contextuelle Sélectionner un panneau

  • Vous pouvez commuter la vue de l’éditeur dans cet onglet en appuyant ou en cliquant sur une entrée dans la liste déroulante.
  • Vous pouvez réorganiser les onglets statiques à l’aide des poignées de glissement.
NOTE

Les onglets ne sont pas sélectionnables par l’auteur en mode Édition. Utilisez le mode Aperçu ou l’option Afficher comme publié(e) pour interagir avec les onglets comme un lecteur du contenu publié.

Boîte de dialogue de conception

La boîte de dialogue de conception permet à l’auteur du modèle de définir quels composants peuvent être ajoutés en tant qu’éléments au composant Onglets et de définir les styles personnalisés disponibles pour l’auteur du contenu.

Onglet Composants autorisés

L’onglet Composants autorisés permet de définir quels composants peuvent être ajoutés en tant qu’éléments au composant Onglets par l’auteur du contenu.

L’onglet Composants autorisés fonctionne de la même manière que l’onglet du même nom lors de la définition de la stratégie et des propriétés d’un conteneur de mises en page dans l’éditeur de modèles.

Onglet Styles

Le composant Onglets prend en charge le système de style AEM.

Sur cette page