Créer ou personnaliser un thème de formulaire adaptatif introduction-to-theme

Version
Lien de l’article
AEM as a Cloud Service
Cliquez ici
AEM 6.5
Cet article

Dans AEM Forms 6.5, un thème est une bibliothèque cliente AEM utilisée pour définir les styles, c’est-à-dire l’aspect d’un formulaire adaptatif. Un thème contient des détails de style pour les composants et les panneaux. Ces styles incluent des propriétés telles que les couleurs d’arrière-plan, les couleurs d’état, la transparence, l’alignement et la taille. Lorsque vous appliquez un thème, le style spécifié se reflète sur les composants correspondants. Un thème est géré indépendamment sans référence à un formulaire adaptatif et peut être réutilisé dans plusieurs formulaires adaptatifs.

Thèmes disponibles available-theme

L’environnement AEM 6.5 fournit les thèmes répertoriés ci-dessous pour les formulaires adaptatifs basés sur les composants principaux :

Comprendre la structure des thèmes understanding-structure-of-theme

Un thème est un package qui englobe le fichier CSS, les fichiers JavaScript et les ressources (comme les icônes) qui définissent le style de votre formulaire adaptatif. Un thème de formulaire adaptatif suit une organisation spécifique composée des composants suivants :

  • src/theme.scss : ce dossier comprend le fichier CSS qui a un large impact sur l’ensemble du thème. Il sert d’emplacement centralisé pour définir et gérer le style et le comportement de votre thème. En apportant des modifications à ce fichier, vous pouvez apporter des modifications appliquées de manière universelle à l’ensemble du thème, en influençant l’aspect et les fonctionnalités de vos pages de formulaires adaptatifs et d’AEM Sites.

  • src/site : ce dossier contient des fichiers CSS qui sont appliqués à l’ensemble de la page d’un site AEM. Ces fichiers se composent de code et de styles qui affectent la fonctionnalité globale et la disposition de la page de votre site AEM. Toutes les modifications apportées ici sont répercutées sur toutes les pages de votre site.

  • src/components : les fichiers CSS de ce dossier sont conçus pour des composants principaux d’AEM individuels. Chaque dossier dédié d’un composant comprend un fichier .scss qui met en forme ce composant particulier dans un formulaire adaptatif. Par exemple, le fichier /src/components/button/_button.scss contient des informations de style pour le composant Bouton du formulaire adaptatif.

    Structure du thème de zone de travail

  • src/resources : ce dossier contient des fichiers statiques tels que des icônes, des logos et des polices. Ces ressources sont utilisées pour améliorer les éléments visuels et la conception globale de votre thème.

Créer un thème

AEM Forms 6.5 fournit les thèmes répertoriés ci-dessous pour les formulaires adaptatifs basés sur les composants principaux.

Vous pouvez personnaliser n’importe lequel de ces thèmes pour créer un thème.

Personnaliser un thème customize-a-theme-core-components-based-adaptive-forms

La personnalisation d’un thème fait référence au processus de modification et de personnalisation de l’aspect d’un thème. Lorsque vous personnalisez un thème, vous apportez des modifications à ses éléments de conception, à sa disposition, à ses couleurs, à sa typographie et parfois au code sous-jacent. Vous pouvez ainsi créer une apparence unique et personnalisée de votre site web ou de votre application tout en conservant la structure et les fonctionnalités de base fournies par le thème.

NOTE
  • Utilisez le gestionnaire de modules pour déployer un thème sur toutes les instances de création et de publication.
  • Une bibliothèque cliente de thème est importée ou exportée via le gestionnaire de modules comme tout autre module.

Prérequis pour personnaliser un thème prerequisites

  • Activation des composants principaux des formulaires adaptatifs pour votre environnement.

  • Installation de la dernière version d’Apache Maven. Apache Maven est un outil d’automatisation de création couramment utilisé dans les projets Java™. L’installation de la dernière version vous garantit les dépendances nécessaires à la personnalisation du thème.

  • Découvrez comment créer une bibliothèque cliente dans Adobe Experience Manager. AEM fournit des bibliothèques clientes qui vous permettent de stocker le code côté client dans le référentiel, de le classer dans des catégories, et de définir quand et comment chaque catégorie de code doit être diffusée au client ou à la cliente.

  • Installez un éditeur de texte brut. Par exemple, Microsoft® Visual Studio Code. L’utilisation d’un éditeur de texte brut tel que Microsoft® Visual Studio Code fournit un environnement convivial pour la création et la modification de fichiers de thème.

  • Assurez-vous que votre environnement AEM Forms est opérationnel.

Considérations pour personnaliser un thème consideration

  • Assurez-vous que vous utilisez le projet Archetype utilisé pour activer les composants principaux des formulaires adaptatifs sur votre environnement pour personnaliser vos thèmes.

  • Lors de la publication d’un formulaire adaptatif, les bibliothèques clientes ne sont pas automatiquement publiées sur l’instance de publication. Veillez à publier manuellement la bibliothèque cliente référencée dans un formulaire adaptatif dans vos environnements de publication.

  • Adobe recommande de ne pas modifier les noms de classe des bibliothèques clientes.

Personnaliser un thème customize-a-theme-core-components

La création ou la personnalisation d’un thème est un processus à plusieurs étapes. Effectuez les étapes dans l’ordre indiqué pour créer/personnaliser le thème :

Les exemples fournis dans le document sont basés sur le thème Zone de travail, mais vous pouvez cloner n’importe quel thème et le personnaliser en suivant les mêmes instructions. Ces instructions s’appliquent à n’importe quel thème, ce qui vous permet de modifier des thèmes en fonction de vos besoins spécifiques.

1. Cloner le référentiel Git du thème clone-git-repo-of-theme

Pour cloner un thème pour les formulaires adaptatifs basés sur les composants principaux, choisissez l’un des thèmes suivants :

Suivez les instructions suivantes pour cloner un thème :

  1. Ouvrez l’invite de commande ou la fenêtre de terminal dans votre environnement de développement local.

  2. Exécutez la commande git clone pour cloner un thème.

    code language-none
       git clone [Path of Git Repository of the theme]
    

    Remplacez le [chemin du référentiel Git du thème] par l’URL réelle du référentiel Git correspondant du thème.

    Par exemple, pour cloner le thème Zone de travail, exécutez la commande suivante :

    code language-none
       git clone https://github.com/adobe/aem-forms-theme-canvas
    
  3. Sélectionnez Approbation des auteurs de tous les fichiers du dossier parent et cliquez sur Oui, je fais confiance aux auteurs.

Une fois la commande exécutée correctement, vous disposez d’une copie locale du thème sur votre ordinateur dans le dossier aem-forms-theme-canvas.

2 . Personnaliser le thème customize-the-theme

Vous avez la possibilité de personnaliser des composants individuels ou d’effectuer des modifications au niveau du thème à l’aide des variables globales d’un thème. La modification des variables globales a un effet en cascade sur tous les composants individuels. Vous pouvez, par exemple, utiliser des variables globales pour modifier la couleur de bordure de tous les composants d’un formulaire adaptatif ou appliquer une couleur de fond accrocheuse aux boutons d’appel à l’action. Vous pouvez :

Définir des styles de niveau de thème theme-customization-global-level

Le fichier variable.scss contient les variables globales du thème. En mettant à jour ces variables, vous pouvez apporter des modifications liées au style au niveau du thème. Pour appliquer des styles au niveau du thème, procédez comme suit :

  1. Ouvrez le fichier <your-theme-sources>/src/site/_variables.scss en mode d’édition.

  2. Modifiez la valeur de n’importe quelle propriété. Par exemple, la couleur d’erreur par défaut est le rouge. Pour changer la couleur de l’erreur du rouge au bleu, modifiez le code hexadécimal de la couleur de la variable $error. Par exemple, $error: #196ee5.

    Exemple : couleur d’erreur définie sur bleu

  3. Enregistrez et fermez le fichier.

De même, vous pouvez utiliser la variable variable.scss pour définir la famille et le type de polices, les couleurs du thème et de la police, la taille de la police, l’espacement des thèmes, l’icône d’erreur, les styles de bordure du thème et d’autres variables ayant un impact sur plusieurs composants de formulaire adaptatif.

Définir des styles de niveau de composant component-based-customization

Vous avez également la possibilité de personnaliser la police, la couleur, la taille et d’autres propriétés CSS des composants principaux spécifiques aux formulaires adaptatifs, tels que les boutons, cases à cocher, conteneurs, pieds de page, etc. En modifiant le fichier CSS associé au composant spécifique, vous pouvez aligner son style sur l’image de marque de votre organisation. Pour personnaliser le style d’un composant, procédez comme suit :

  1. Ouvrez le fichier <your-theme-sources>/src/components/<component>/<component.scss> pour le modifier. Par exemple, pour modifier la couleur de police du composant Bouton, ouvrez le fichier <your-theme-sources>/src/components/button/button.scss.

  2. Modifiez la valeur de n’importe quelle variable selon vos besoins. Par exemple, pour changer la couleur du composant Bouton lorsque vous passez la souris sur Vert, modifiez la valeur de la propriété color: $white dans la classe cmp-adaptiveform-button__widget:hover vers le code hexadécimal #12b453 ou une autre nuance de vert. Le code final ressemble à ce qui suit :

    code language-none
     .cmp-adaptiveform-button__widget:hover {
     background: $dark-gray;
     color: #12b453;
     }
    
  3. Enregistrez et fermez le fichier.

NOTE
Lorsqu’un style est défini au niveau du thème et du composant, le style défini au niveau du composant est prioritaire.

3. Préparer le thème pour le déploiement generate-the-clientlib

Pour déployer un thème sur une instance AEM, il doit être converti en bibliothèque cliente. Pour convertir le thème en bibliothèque cliente, procédez comme suit :

  1. Ouvrez l’invite de commandes ou la fenêtre du terminal.

  2. Accédez au dossier <your-theme-sources>. Par exemple, C:\aem-forms-theme-canvas.

  3. Exécutez la commande suivante :

    code language-none
       npm run create-clientlib --category=adaptiveform.theme.[yourtheme]
    

    Remplacez [yourtheme] par le nom de votre thème personnalisé. Par exemple, si le nom du thème personnalisé est customcanvastheme, exécutez la commande suivante :

    code language-none
        npm run create-clientlib --category=adaptiveform.theme.customcanvastheme
    

    Une fois la commande exécutée, un dossier de bibliothèque cliente est créé ici : themerepo\theme-clientlibs\[yourtheme].

    Génération de bibliothèques clientes

    Emplacement des bibliothèque clientes

4. Déployer le thème sur un environnement local deploy-the-theme-on-a-local-environment

Pour déployer le thème dans votre environnement de développement ou de test local, procédez comme suit :

  1. Copiez la bibliothèque cliente créée dans la section précédente vers votre projet Archetype, à l’emplacement suivant :

    /ui.apps/src/main/content/jcr_root/apps/[AEM Archetype Project Folder]/clientlibs/<yourtheme>

  2. Ouvrez l’invite de commandes ou le terminal.

  3. Accédez au répertoire racine de votre projet AEM Archetype, à savoir le projet utilisé pour activer les composants principaux de formulaire adaptatif.

  4. Exécutez la commande suivante pour déployer le thème personnalisé sur votre environnement :

    mvn clean install

    Version de bibliothèque cliente

5. Déployer un thème sur votre environnement de production deploy-theme

Une fois que vous avez testé le thème sur votre environnement de développement local, vous pouvez continuer à le déployer sur vos environnements de production, y compris les instances de création et de publication. Pour déployer le thème sur vos environnements de production, procédez comme suit :

  1. Connectez-vous à votre environnement AEM.
  2. Ouvrez le gestionnaire de modules. L’URL par défaut est https://localhost:4502/crx/packmgr/index.jsp.
  3. Cliquez sur Télécharger le package et cliquez sur Parcourir.
  4. Accédez à [AEM Archetype Project Folder]\all\target[appid].all-[version].zip et sélectionnez-le. Cliquez sur Ouvrir.
  5. Cliquez sur Installer. Répétez l’étape pour tous les environnements de production.

Une fois le package installé, le thème peut être sélectionné.

Bibliothèque cliente de thème

NOTE
Si vous rencontrez des difficultés pour accéder à la boîte de dialogue de connexion sur une instance de publication lors de l’installation du package via le gestionnaire de modules, essayez de vous connecter à l’aide de l’URL suivante : http://[Publish Server URL]:[PORT]/system/console. Cela vous permet d’accéder à l’instance de publication et de poursuivre le processus d’installation.

Appliquer un thème à un formulaire adaptatif using-theme-in-adaptive-form

Les étapes à suivre pour appliquer un thème à un formulaire adaptatif sont les suivantes :

  1. Connectez-vous à l’instance de création AEM locale.

  2. Entrez vos informations d’identification dans la page de connexion d’Experience Manager. Sélectionnez Adobe Experience Manager  > Formulaires  > Formulaires et documents.

  3. Cliquez sur Créer  > Formulaires adaptatifs.

  4. Sélectionnez un modèle de composant principal de formulaire adaptatif et cliquez sur Suivant. Ajouter des propriétés s’affiche.

  5. Spécifiez la variable Nom pour votre formulaire adaptatif.

    note note
    NOTE
    • Par défaut, le thème adaptiveform.theme.canvas3 est sélectionné.
    • Vous pouvez choisir un thème différent dans le menu déroulant Bibliothèque cliente de thème.
  6. Cliquez sur Créer.

Les thèmes de formulaire adaptatif sont utilisés dans le cadre d’un modèle de formulaire adaptatif pour définir le style lors de la création d’un formulaire adaptatif.

Supprimer un thème delete-a-theme

Pour supprimer les thèmes inutilisés ou non pertinents :

  1. Connectez-vous à votre instance de création.
  2. Ouvrez http://[Publish Server URL]:[PORT]/crx/de/index.jsp.
  3. Accédez à apps/[AEM Archetype Project Folder]/clientlibs/[yourtheme].
  4. Supprimez le dossier de thème et enregistrez les modifications.

Questions fréquentes faq

Question : Quelle personnalisation est prioritaire lorsque vous effectuez des personnalisations dans un dossier de thème au niveau global et au niveau des composants ?

Réponse : Lorsqu’un style est défini aux niveaux du thème et du composant, le style défini au niveau du composant est prioritaire.

Question : Quelles sont les étapes à suivre si le thème personnalisé n’est pas visible dans la variable Bibliothèque cliente du thème  ?

Réponse : Si votre thème personnalisé ne s’affiche pas dans le menu déroulant Bibliothèque cliente du thème, procédez comme suit :

  1. Accédez à l’emplacement où vous avez ajouté votre bibliothèque cliente de thèmes personnalisée. Le chemin recommandé est : /ui.apps/src/main/content/jcr_root/apps[AEM Archetype Project Folder]/clientlibs/<yourtheme>.

  2. Ouvrez le fichier .content.xml et incluez les métadonnées suivantes :

    code language-none
        formstheme:true
        allowproxy:true
    
  3. Enregistrez le fichier et redéployez le thème.

Voir également

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2