Créer ou personnaliser un thème de formulaire adaptatif introduction-to-theme
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. -
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.
- 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 :
-
Ouvrez l’invite de commande ou la fenêtre de terminal dans votre environnement de développement local.
-
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
-
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 :
-
Ouvrez le fichier
<your-theme-sources>/src/site/_variables.scss
en mode d’édition. -
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
. -
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 :
-
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
. -
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 classecmp-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; }
-
Enregistrez et fermez le fichier.
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 :
-
Ouvrez l’invite de commandes ou la fenêtre du terminal.
-
Accédez au dossier
<your-theme-sources>
. Par exemple,C:\aem-forms-theme-canvas
. -
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é estcustomcanvastheme
, 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]
.
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 :
-
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>
-
Ouvrez l’invite de commandes ou le terminal.
-
Accédez au répertoire racine de votre projet AEM Archetype, à savoir le projet utilisé pour activer les composants principaux de formulaire adaptatif.
-
Exécutez la commande suivante pour déployer le thème personnalisé sur votre environnement :
mvn clean install
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 :
- Connectez-vous à votre environnement AEM.
- Ouvrez le gestionnaire de modules. L’URL par défaut est
https://localhost:4502/crx/packmgr/index.jsp
. - Cliquez sur Télécharger le package et cliquez sur Parcourir.
- Accédez à
[AEM Archetype Project Folder]\all\target[appid].all-[version].zip
et sélectionnez-le. Cliquez sur Ouvrir. - 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é.
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 :
-
Connectez-vous à l’instance de création AEM locale.
-
Entrez vos informations d’identification dans la page de connexion d’Experience Manager. Sélectionnez Adobe Experience Manager > Formulaires > Formulaires et documents.
-
Cliquez sur Créer > Formulaires adaptatifs.
-
Sélectionnez un modèle de composant principal de formulaire adaptatif et cliquez sur Suivant. Ajouter des propriétés s’affiche.
-
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.
- Par défaut, le thème
-
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 :
- Connectez-vous à votre instance de création.
- Ouvrez
http://[Publish Server URL]:[PORT]/crx/de/index.jsp
. - Accédez à
apps/[AEM Archetype Project Folder]/clientlibs/[yourtheme]
. - 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 :
-
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>
. -
Ouvrez le fichier
.content.xml
et incluez les métadonnées suivantes :code language-none formstheme:true allowproxy:true
-
Enregistrez le fichier et redéployez le thème.
Voir également
- Créer un formulaire adaptatif basé sur des composants principaux
- Utiliser l’éditeur de règles pour ajouter un comportement dynamique au formulaire
- Créer ou personnaliser des thèmes pour les formulaires adaptatifs basés sur les composants principaux
- Création d’un modèle pour les formulaires adaptatifs basés sur les composants principaux
- Création ou ajout d’un formulaire adaptatif à une page AEM Sites ou à un fragment d’expérience
- Exemples de modèles de thèmes et de modèles de données de formulaire