Composant de liste de fragments de contenu

Le composant Liste de fragments de contenu des composants principaux permet d’afficher une liste de fragments de contenu.

Utilisation

Le composant Liste de fragments de contenu des composants principaux permet d’inclure une liste de fragments de contenu sur une page basée sur un modèle de fragment de contenu. Cette opération peut s’avérer particulièrement utile pour créer un contenu headless qui peut être facilement utilisé par d’autres applications.

• La liste et ses propriétés peuvent être sélectionnées dans la boîte de dialogue de configuration.
• Des styles peuvent être appliqués au composant dans la boîte de dialogue de conception.

Version et compatibilité

La version actuelle du composant Fragment de contenu est v2, qui a été introduite avec la version 2.18.0 des composants principaux en février 2022. 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.

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 de liste de fragments de contenu et voir des exemples d’options de configuration et de sortie HTML et JSON, consultez la bibliothèque de composants.

Détails techniques

La documentation technique la plus récente sur le composant Liste des fragments de contenu 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 configuration

La boîte de dialogue de configuration permet à l’auteur du contenu de définir les fragments de contenu compris dans la liste et les éléments de ces fragments à inclure.

Onglet Propriétés

L’onglet Propriétés définit les fragments de contenu inclus dans la liste. Cela repose principalement sur un modèle de fragment de contenu sélectionné, mais il existe d’autres options de filtrage disponibles.

• Modèle : chemin d’accès au modèle de fragment de contenu sur lequel repose la liste.
  • Par défaut, tous les fragments de contenu du modèle définis comme chemin d’accès au modèle sont inclus dans la liste.
• Chemin d’accès parent : chemin d’accès parent à partir duquel la liste doit être créée.
  • Les fragments de contenu reposant sur le chemin d’accès au modèle sélectionné sont filtrés sur ceux du chemin d’accès parent spécifié.
    • Cliquez ou appuyez sur le bouton Boîte de dialogue Ouvrir la sélection à droite du champ pour spécifier le chemin.
• Balises : seuls les fragments de contenu avec les balises spécifiées seront inclus dans la liste.
  • Cliquez ou appuyez sur le bouton Boîte de dialogue Ouvrir la sélection à droite du champ pour spécifier les balises.
  • Cliquez ou appuyez sur le X à côté des balises sélectionnées pour les supprimer.
• Classer par : champ du modèle de fragment de contenu selon lequel la liste sera triée
  • Seuls les champs de texte (notamment les champs numériques, de date et d’heure) peuvent être sélectionnés.
• Ordre de tri : mode de tri de la liste par le champ Classer par
  • Croissant ou décroissant
• Nombre max. d’éléments : nombre maximal d’éléments à afficher dans la liste
  • Aucune valeur ne renverra tous les éléments.
• 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 Éléments

Par défaut, tous les éléments du modèle de fragment de contenu seront inclus dans la liste (sauf si le champ Nombre max. d’éléments applique une limite). L’onglet Éléments permet de spécifier des éléments spécifiques à inclure.

• Éléments : seuls les éléments des fragments de contenu figurant dans la liste spécifiée apparaissent.
  • Cliquez ou appuyez sur le bouton Ajouter pour ajouter un nouvel élément.
  • Cliquez ou appuyez sur le bouton Supprimer pour supprimer un élément sélectionné.
  • Faites glisser la poignée Ordre pour réorganiser l’ordre des éléments.

Onglet Styles

Le composant Liste de fragments de contenu prend en charge le système de style AEM.

Utilisez la liste déroulante pour sélectionner les styles à appliquer au composant. Les sélections effectuées dans la boîte de dialogue de modification ou dans la barre d’outils du composant ont le même effet.

Pour que le menu déroulant soit disponible, les styles doivent être configurés pour ce composant dans la boîte de dialogue de conception.

Boîte de dialogue de conception

Onglet Styles

Le composant Liste de fragments de contenu prend en charge le système de style AEM.