Modèles de page - Statiques page-templates-static

Un modèle sert à créer une page. Il définit les composants pouvant être utilisés dans l’étendue sélectionnée. Un modèle est une hiérarchie de noeuds ayant la même structure que la page à créer, mais sans contenu réel.

Chaque modèle vous présente une sélection de composants disponibles.

Propriétés et noeuds enfants d’un modèle properties-and-child-nodes-of-a-template

Un modèle est un noeud de type cq:Template qui contient les propriétés et les noeuds enfants suivants :

Un modèle sert de fondement pour une page.

Pour créer une page, le modèle doit être copié (node-tree /apps/<myapp>/template/<mytemplate>) vers la position correspondante dans l’arborescence : c’est ce qui se passe si une page est créée en utilisant l’onglet Sites web.

Cette action de copie confère également à la page son contenu initial (généralement le contenu de niveau supérieur uniquement) et la propriété sling:resourceType, le chemin d’accès au composant de page utilisé pour rendre la page (tout ce qui est présent dans le nœud enfant jcr:content).

Structuration des modèles how-templates-are-structured

Deux aspects doivent être pris en compte :

Structure d’un modèle the-structure-of-a-template

Un modèle est créé sous un noeud de type cq:Template.

Différentes propriétés peuvent être définies, notamment :

Ce noeud contient un noeud jcr:content (cq:PageContent) qui doit être utilisé comme base du noeud de contenu des pages résultantes ; cette référence, à l’aide de sling:resourceType, le composant à utiliser pour le rendu du contenu réel d’une nouvelle page.

Ce composant est utilisé pour définir la structure et la conception du contenu lors de la création d’une page.

Contenu produit par un modèle the-content-produced-by-a-template

Les modèles servent à créer des pages de type cq:Page (comme mentionné précédemment, une page est un type spécial de composant). Chaque page AEM possède un nœud structuré jcr:content. Celui-ci :

Modèles par défaut default-templates

AEM offre un certain nombre de modèles par défaut prêts à l’emploi. Dans certaines situations, vous pouvez utiliser les modèles tels quels. Dans ce cas, vous devez vous assurer que le modèle est disponible pour votre site web.

Par exemple, AEM est fourni avec plusieurs modèles, y compris une page de contenu et une page d’accueil.

Affichage des modèles par défaut displaying-default-templates

Pour afficher la liste de tous les modèles du référentiel, procédez comme suit :

Dans la plupart des cas, c’est à partir d’un modèle existant que vous élaborerez un nouveau modèle pour votre usage personnel. Voir Développement de modèles de page pour plus d’informations.

Afin d’activer un modèle existant pour votre site web et de l’afficher dans la boîte de dialogue Créer une page lors de la création d’une page directement sous Sites web à partir de la console Sites web, définissez la propriété allowedPaths du nœud de modèle sur : /content(https://experienceleague.adobe.com/.*?lang=fr)?

Application de conceptions de modèle how-template-designs-are-applied

Lorsque des styles sont définis dans l’interface utilisateur à l’aide du mode Conception, la conception est conservée à l’emplacement exact du nœud de contenu pour lequel le style est défini.

Si les conceptions ne sont appliquées qu’en mode de conception, les sections suivantes, la Résolution du chemin de conception, l’Arborescence de décision et l’Exemple ne sont pas applicables.

Résolution du chemin de conception design-path-resolution

Lors du rendu du contenu à partir d’un modèle statique, AEM tentera d’appliquer la conception et les styles les plus pertinents pour le contenu, en parcourant la hiérarchie du contenu.

AEM détermine le style le plus pertinent pour un nœud de contenu dans l’ordre suivant :

Dans les deux derniers cas, s’il existe plusieurs conceptions applicables, utilisez celle la plus proche du nœud de contenu.

Arborescence de décision decision-tree

Il s’agit d’une représentation graphique de la logique de Résolution du chemin de conception.

Exemple example

Penchez-vous sur une simple structure de contenu comme celle qui suit, où une conception peut s’appliquer à l’un des nœuds :

/root/branch/leaf

Le tableau suivant décrit comment AEM choisira une conception.

Développement de modèles de page developing-page-templates

Les modèles de pages AEM sont simplement des modèles utilisés pour créer des pages. Ils peuvent contenir le moins ou autant de contenu initial que nécessaire, leur rôle étant de créer les structures de noeud initiales correctes, avec les propriétés requises (principalement sling:resourceType) définies pour permettre l’édition et le rendu.

Création d’un modèle (basé sur un modèle existant) creating-a-new-template-based-on-an-existing-template

Inutile de dire qu’un nouveau modèle peut être entièrement créé de toutes pièces, mais en pratique un modèle existant est copié et modifié pour faire gagner du temps. Par exemple, les modèles de Geometrixx peuvent être utilisés pour vous aider à démarrer.

Pour créer un modèle à partir d'un modèle existant :

Mise à disposition d’un modèle existant making-an-existing-template-available

Cet exemple illustre comment autoriser l’utilisation d’un modèle pour certains chemins de contenu. Les modèles disponibles pour l’auteur de la page lors de la création de pages sont déterminés par la logique définie dans Disponibilité du modèle.