Mettre en forme des éléments pour les formulaires adaptatifs

ATTENTION

AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Prérequis

Connaissances en matière de CSS et structure LESS.

Éléments personnalisables

Cet article répertorie les classes CSS de formulaires adaptatifs disponibles publiquement. Vous pouvez tirer parti de ces classes pour appliquer un style aux divers composants d’un formulaire adaptatif. La mise en forme des composants de création, tels que les boîtes de dialogue et les barres d’état qui affichent des avertissements, ne fait pas partie de cet article. Utilisez ces éléments de style pour créer des styles (en utilisant CSS ou Less) uniquement lorsque vous ne pouvez pas mettre en forme des composants à l’aide de éditeur de thèmes.

Personnalisation des styles dans les formulaires adaptatifs

La structure LESS simplifie le cas d’utilisation pour personnaliser les styles dans les formulaires adaptatifs. La structure vous permet de définir des styles à l’aide d’un ensemble de variables et de fonctions (mixins). La structure LESS aide à réduire la taille du code regroupé et augmente sa capacité de réutilisation.

Vous pouvez personnaliser les styles des formulaires adaptatifs comme suit :

  • Modification du thème
  • Modifier le style du composant

Modification du thème

Vous pouvez modifier le thème d’un formulaire adaptatif pour vous assurer que son apparence est cohérente avec les pages web auxquelles le formulaire adaptatif est intégré.

Les modifications de l’aspect général du formulaire adaptatif via les propriétés CSS font généralement partie des modifications du thème. Les principales modifications de la convivialité du formulaire adaptatif, telles que les modifications de disposition et le positionnement des composants, ne sont pas considérées comme des modifications du thème.

Selon l’amorçage, l’ensemble suivant de propriétés CSS définit le thème d’une page web :

  • Couleur d’arrière-plan
  • Bordure (type, couleur, épaisseur)
  • Couleur de la police
  • Remplissage
  • Marge
  • Taille de police
  • LineHeight

Actuellement, les variables LESS sont définies uniquement pour ces propriétés des différents éléments d’un formulaire adaptatif.

Modification du style de composant

Vous pouvez modifier l’apparence, la disposition, le positionnement et la visibilité des éléments. Pour réaliser cette tâche, créez ou mettez à jour vos fichiers .css personnalisés pour inclure les mises en forme répertoriées dans cet article.

Pour appliquer un style à un formulaire adaptatif, ouvrez le formulaire adaptatif pour l’édition, ouvrez les propriétés du conteneur de formulaires adaptatifs et spécifiez le chemin du fichier CSS personnalisé dans l’onglet de base. Mises en forme par défaut du formulaire adaptatif remplacé par les mises en forme répertoriées dans le fichier .css personnalisé.

Composants

Les composants décrits dans cet article possèdent leurs classes CSS prédéfinies. Vous pouvez modifier les variables pour modifier les styles dans les classes CSS. Vous pouvez également réécrire la classe entière. Cette section décrit les classes dans les composants et les styles que vous pouvez modifier à l’aide de variables.

Définition de style du conteneur

Un conteneur est le composant de niveau supérieur. D’autres panneaux et champs se trouvent sous le composant de conteneur.

Classe CSS

guideContainerNode

Description des variables

Description des variables

container-bgColor

Couleur d’arrière-plan du conteneur

container-padding

Marge intérieure du conteneur

container-margin

Marge du conteneur

container-fontColor

Couleur de police du conteneur

Définition de style du champ

Les formulaires adaptatifs incluent différents types de champs. Chaque champ a un nom de classe unique, qui est le nom du champ. Le champ possède également un nom de classe commun guideFieldNode.

Les champs incluent des libellés, des widgets, des descriptions d’aide (descriptions longues et courtes), ainsi que des icônes d’aide de champ (point d’interrogation).

Classe CSS

guideFieldNode

Variables

Description

field-padding

Marge intérieure du champ

field-error-font-color

Couleur de police du message d’erreur du champ

field-error-font-size

Taille de police du message d’erreur du champ

Définition de style de libellé

L’élément HTML label utilisé pour le champ inclut les classes left ou top selon que le libellé se trouve en haut ou à gauche.

Classe CSS

guideFieldLabel

Variables

Description

label-font-color

Couleur de police du libellé du champ

label-font-size

Taille de police du libellé du champ

label-line-height

 Propriété de hauteur de ligne CSS pour le libellé du champ

label-font-weight

 Propriété d’épaisseur de police CSS du libellé du champ

label-margin

Marge du libellé du champ

Les règles CSS pour le libellé sont appliquées à l’aide de la classe guideFieldLabel. Si vous êtes un auteur, remplacez cette règle pour que vos modifications personnalisées soient visibles.

Définition de style des widgets

Selon leur type, les widgets contiennent également des classes. En règle générale, les widgets incluent la classe guideFieldWidget. Les widgets fournis avec HTML utilisent normalement l’entrée standard de l’élément de HTML et sélectionnent . Le style est effectué en conséquence. Vous ne pouvez pas mettre en forme un widget personnalisé en modifiant les variables.

Classe CSS

guideFieldWidget

Variables

Description

widgets-bg-color

 Couleur d’arrière-plan des widgets (ne fonctionne pas pour les cases à cocher et les boutons radio)

widgets-border-color

Couleur de bordure des widgets

widgets-border-thickness

Taille de bordure des widgets

widgets-border-radius

Rayon de bordure des widgets

widgets-border-type

Type de bordure des widgets

widget-border-focus-type

Type de focus des bordures de widget

widgets-border

Style de bordure consolidée des widgets

widgets-font-color

Couleur du texte dans le widget

widgets-font-size

Taille du texte dans le widget

widgets-line-height

 Propriété de hauteur de ligne CSS du widget

widgets-padding

Propriété de remplissage CSS du widget

widgets-focus-border-color

Couleur de bordure lorsque le widget est ciblé

widgets-mandatory-border-color

Couleur de bordure du widget pour les champs obligatoires

widgets-mandatory-bg-color

Couleur d’arrière-plan du widget pour les champs obligatoires

widgets-disabled-bg-color

Couleur d’arrière-plan du widget lorsque le champ est désactivé

widgets-disabled-font-color

Couleur de police du widget lorsque le champ est désactivé

widgets-disabled-border-color

Couleur de bordure du widget lorsque le champ est désactivé

widget-height

 Hauteur du widget (ne fonctionne pas pour les cases à cocher et les boutons radio)

checkbutton-height

Hauteur de la case à cocher et du bouton radio.

listboxwidget-height

Hauteur maximale d’une liste déroulante à sélection multiple

Restrictions de la définition de style de widget

La mise en forme des champs ciblés, obligatoires et désactivés est limitée à l’aide de variables. Vous pouvez toutefois la modifier en remplaçant les styles. La restriction utilisant des variables est principalement fournie pour garder le nombre de variables sous contrôle. La restriction peut être relâchée si l’aspect d’un champ change considérablement car il est dans l’un des états décrits précédemment.

Description d’aide

Un auteur peut spécifier le contenu d’aide dans les champs à l’aide de composants de descriptions longue et courte. Les deux composants ont une classe commune .guideHelpDescription et une autre classe .short/.long, en fonction du type de description. Le contenu d’aide est intégré dans un élément de paragraphe pour remplacer la définition de style de la description. La description de l’aide (longue et courte) est modifiée à l’aide de variables commençant par widgetshelp, comme indiqué dans le tableau suivant :

Variables

Description

widgets-help-long-bg-color

Couleur d’arrière-plan de l’aide longue des widgets

widgets-help-long-border-color

Couleur de bordure de l’aide longue des widgets

widgets-help-long-border-indicator-color

Couleur de bordure d’indicateur gauche de l’aide longue des widgets

widgets-help-short-bg-color

Couleur d’arrière-plan de l’aide courte des widgets

widgets-help-short-color

Couleur de police de l’aide courte des widgets

widgets-help-short-tooltip-bg-color

Couleur d’arrière-plan de l’info-bulle d’aide courte des widgets

widgets-help-short-tooltip-color

Couleur de police de l’info-bulle d’aide courte des widgets

Termes et conditions

Le widget des termes et conditions (TnC ) vous permet de spécifier les termes et conditions. Vous pouvez personnaliser le widget à l’aide des variables décrites dans le tableau suivant.

Variables

Description
tnc-unvisited Couleur de police du lien TnC non visité.
tnc-visited Couleur de police du lien TnC visité.

Bouton

Les boutons sont également des widgets. Toutefois, leur style est légèrement différent des widgets. Dans les formulaires adaptatifs, l’un des éléments suivants constitue un bouton :

  • input[type = text]
  • Bouton
  • élément avec la classe .button

Code HTML du bouton :

<button type="button" >

<span class="iconButtonicon"></

span>

<span class="iconButtonlabel"></

span>

</button>

Classe CSS

Description

iconButton-icon

Fournit des icônes pour le bouton

iconButton-label

Définit le style du libellé/de la légende du bouton

Variables

Description

button-border-size

Taille de bordure des boutons

button-border-type

Type de bordure

button-padding

Propriété de remplissage CSS du bouton

button-font-size

Taille de police du bouton

button-background-color

Couleur d’arrière-plan du bouton

button-font-color

Couleur de police du bouton

button-border-color

Couleur de bordure du bouton

button-large-padding

Marge intérieure des grands boutons (boutons avec la classe .buttonlarge)

button-large-font-size

Taille de police des grands boutons

button-small-padding

Marge intérieure des petits boutons (boutons avec la classe .buttonsmall)

button-small-font-size

Taille de police des petits boutons

button-info-background-color

Couleur d’arrière-plan des boutons informatifs (boutons avec la classe .buttoninformative)

button-info-font-color

Couleur de police des boutons informatifs

button-info-border-color

Couleur de bordure des boutons informatifs

button-warning-background-color

Couleur d’arrière-plan des boutons d’avertissement (boutons avec la classe .buttonwarning)

button-warning-font-color

Couleur de police des boutons d’avertissement

button-warning-border-color

Couleur de bordure des boutons d’avertissement

button-alert-background-color

Couleur d’arrière-plan des boutons d’alerte (boutons avec la classe .buttonalert)

button-alert-font-color

Couleur de police des boutons d’alerte

button-alert-border-color

Couleur de bordure des boutons d’alerte

Point d’interrogation

Pour les widgets, un point d’interrogation s’affiche lorsqu’un auteur ajoute une description longue dans le contenu de l’aide. L’icône par défaut fournie dans l’amorçage est utilisée. Pour utiliser une icône personnalisée, vous pouvez personnaliser les icônes d’amorçage.

Classe CSS

guideHelpQuestionMark

Variables

Description

questionmark-font-color

Couleur de l’icône

questionmark-hover-font-color

Couleur de l’icône lorsque le curseur survole au-dessus

Tableau

Vous pouvez modifier le thème de couleur de l’en-tête et des rangées de contenu d’un tableau en utilisant les variables suivantes.

Variables

Description

table-header-bg-color

Couleur d’arrière-plan de la ligne d’en-tête. La valeur par défaut est #333.

table-odd-row-bg-color

Couleur d’arrière-plan de la ligne de contenu impaire. La valeur par défaut est rgb(255, 255, 255).

table-even-row-bg-color

Couleur d’arrière-plan pour la ligne de contenu paire. La valeur par défaut est #eee.

Pièce jointe

Le widget Pièce jointe des formulaires adaptatifs vous permet de télécharger des fichiers. Vous pouvez également personnaliser le widget à l’aide des variables.

Variables

Description

fileItemPadding

Marge intérieure pour les fichiers affichés dans le widget

fileItemBackground

Couleur d’arrière-plan pour l’élément de fichier

fileItemBorderColor

Couleur de bordure de la bordure supérieure

fileItemColor

Couleur de police pour l’élément de fichier

filePreviewIconColor

Couleur de l’icône d’aperçu (icône d’amorçage) dans le widget

fileItemCommentHeight

Hauteur de commentaire pour l’élément de fichier

Il existe quatre types d’onglets de navigateur. Il s’agit notamment des onglets à gauche, en haut, dans l’assistant et en accordéon. Chaque navigateur possède une classe différente.

Navigateur

Classe CSS

Accordion

.accordion-navigators

tabs on the left

.tab-navigators-vertical

tabs on the top

.tab-navigators

Wizard

.wizard-navigators

Voici le code de HTML de l’élément de navigateur d’onglets (similaire aux onglets d’amorçage) :

<li>

tab title

</li>

Accordion navigator is an exception, it has following barebone

structure:

<div class="accordion.navigators">

<div>

<div class = "guideHeader">

<a>

<span class = "guideSummary" ></span>

........................... repeatable buttons, if the repeatable configuration is set ................................

<div class = "repeatableButtons">

<button name="Add" class="Add"/>

<button name="Remove" class="Remove"/>

</div>

</a>

</div>

................................ panel content ..................................

</div>

</div>

Vous pouvez modifier la définition de style du navigateur à l’aide des règles CSS qui sélectionnent les éléments à l’aide de sélecteurs descendants. Par exemple, pour ajouter un style de décoration de texte à la balise d’ancrage :

Navigateur d’onglets en haut :

.tab-navigators

li a {

text-decoration:

underline;

}

Tab navigator on left:

.tab-navigators-vertical

li a {

text-decoration:

underline;

}

Accordion navigator:

.accordion-navigators .guideHeader a .guideSummary {

text-decoration:

underline;

}

Wizard navigator:

.wizard-navigators

li a {

text-decoration:

underline;

}

En outre, il existe des classes pour définir le style des navigateurs d’onglets (gauche et haut) en fonction de la présence de navigateurs imbriqués ou enfants ou de sous-navigateurs.

Classe CSS

Description

nested_true

Navigateurs d’onglets (gauche et haut) qui ont des navigateurs imbriqués/enfants/sous-navigateurs

nested_false

Navigateurs d’onglets (gauche et haut) qui n’ont pas de navigateurs imbriqués/enfants/sous-navigateurs

La classe guideNavIcon fournit une icône par défaut aux navigateurs d’onglets (gauche et haut) et aux navigateurs de l’assistant.

Classe CSS

guideNavIcon
REMARQUE

Vous pouvez modifier l’icône pour un navigateur particulier en fournissant une classe CSS dans le panneau de création, par exemple <CLASS_NAME>. Vous ajoutez <CLASS_NAME>_nav pour l’icône du navigateur.

Variables

Description

Navigateurs d’onglets

navigator-bg-color

Couleur d’arrière-plan du navigateur d’onglets entier

tabs-bg-color

Couleur d’arrière-plan de l’onglet

tabs-font-color

Couleur de police de l’onglet

tabs-hover-bg-color

Couleur d’arrière-plan de l’onglet au survol

tabs-hover-font-color

Couleur de police de l’onglet au survol

tabs-active-bg-color

Couleur d’arrière-plan lorsque le panneau est ciblé (actif)

tabs-active-font-color

Couleur de police lorsque le panneau est actif

tabs-completed-bg-color

Couleur d’arrière-plan lorsque l’expression d’achèvement du panneau renvoie true (vrai)

tabs-completed-font-color

Couleur de police lorsque l’expression d’achèvement du panneau renvoie true (vrai)

tabs-stepped-bg-color

 Couleur d’arrière-plan lorsque le panneau a été activé une fois mais que l’expression d’achèvement renvoie false (faux)

tabs-stepped-font-color

 Couleur de police lorsque le panneau a été activé une fois mais que l’expression d’achèvement renvoie false (faux)

tabs-border-color

Couleur de bordure de l’onglet

tabs-font-size

Taille de police de l’onglet

tabs-padding

Marge intérieure de l’onglet

tabs-margin

Marge de l’onglet

tabs-vertical-margin

Marge des onglets verticaux

tabs-border-thickness

Taille de bordure des onglets

tabs-min-height

Hauteur minimale des onglets

heirarichal-indent

Retrait des onglets imbriqués

Navigateurs de l’assistant

wizard-navigator-bg-color

 Couleur d’arrière-plan du navigateur entier de l’assistant

wizard-tabs-bg-color

Couleur d’arrière-plan de l’assistant

wizard-tabs-font-color

Couleur de police de l’assistant

wizard-tabs-active-bg-color

Couleur d’arrière-plan lorsque le panneau est ciblé (actif)

wizard-tabs-active-font-color

Couleur de la police lorsque le panneau est ciblé (actif)

wizard-tabs-completed-bg-color

Couleur d’arrière-plan lorsque l’expression d’achèvement du panneau renvoie true (vrai)

wizard-tabs-completed-font-color

Couleur de police lorsque l’expression d’achèvement du panneau renvoie true (vrai)

wizard-tabs-stepped-bg-color

 Couleur d’arrière-plan lorsque le panneau a été activé une fois mais que l’expression d’achèvement renvoie false (faux)

wizard-tabs-stepped-font-color

Couleur de police lorsque le panneau a été activé une fois mais que l’expression d’achèvement renvoie false (faux)

wizard-tabs-border-color

Couleur de l’assistant

wizard-tabs-font-size

Taille de police de l’assistant

wizard-tabs-padding

Marge intérieure de l’assistant

wizard-tabs-border-thickness

Taille de bordure de l’assistant

wizard-nav-bullet-border

Couleur de bordure de la puce du navigateur de l’assistant (devant la légende/le libellé)

wizard-progress-bg-color

Couleur d’arrière-plan de la barre de progression du navigateur de l’assistant

wizard-progress-color

Couleur de remplissage de la barre de progression

Navigateurs en accordéon

accordion-tabs-padding

Marge intérieure de l’accordéon

Définition de style du panneau

Un panneau comporte une barre d’outils facultative et son contenu.

Classe CSS

guidePanelNode

Variables

Description

panel-background-color

Couleur d’arrière-plan du panneau

panel-font-size

Taille de police du texte du panneau

panel-font-color

Couleur de police du texte du panneau

panel-padding

Marge intérieure du panneau

panel-description-font-size

Taille de police de la description du panneau

panel-description-padding

Marge intérieure de la description du panneau

panel-help-bg-color

Couleur d’arrière-plan de l’aide du panneau

panel-help-border-indicator-color

Couleur de bordure de l’indicateur de l’aide du panneau

Le noeud du panneau est divisé en navigateurs et en contenu. Il n’y a pas de composant de définition du style séparé pour le contenu. Les variables décrites sont appliquées sur le navigateur ainsi que sur le contenu.

*Le panneau supérieur (RootPanel) ne dispose pas de cette classe.

Styles mobiles

Barre d’en-tête

Ces variables influent sur la barre d’en-tête visible sur un périphérique mobile ou équipé qui contient un titre de panneau et les navigateurs Suivant et Précédent.

Classe CSS

guide-header-bar

Variables

Description

headerbar-background-color

Couleur d’arrière-plan de la barre d’en-tête

headerbar-font-color

Couleur de police du texte dans la barre d’en-tête

headerbar-padding

Marge intérieure de la barre d’en-tête

Indicateur de défilement

Ces variables influent sur l’indicateur de défilement, qui est une flèche orange qui s’affiche sur un périphérique mobile ou un petit écran. Un indicateur de défilement indique qu’il existe du contenu au-delà de la partie visible de l’écran. Vous pouvez faire défiler l’écran vers le bas pour le voir. Lorsque vous atteignez la fin du contenu, la flèche disparaît.

Classe CSS

mobileScrollIndicator

Variables

Description

scrollIndicatorBottom

Position fixe de l’indicateur de défilement depuis le bas

scrollIndicatorRight

Position fixe de l’indicateur de défilement depuis la droite

scrollIndicatorWidth

Largeur de l’indicateur de défilement

scrollIndicatorHeight

Hauteur de l’indicateur de défilement

Variables spécifiques à la disposition de la barre d’outils fixe pour mobile

Ces variables dans le tableau suivant influent sur la disposition de la barre d’outils fixe pour mobile.

Classe CSS

mobileToolbar

Variables

Description

mobileToolbarBottom

Position fixe de la barre d’outils, sur un périphérique mobile, depuis le bas

mobileToolbarTop

Position fixe de la barre d’outils, sur un périphérique mobile, depuis le haut

mobileToolbarLeft

Position fixe de la barre d’outils, sur un périphérique mobile, depuis la gauche

mobileToolbarRight

Position fixe de la barre d’outils, sur un périphérique mobile, depuis la droite

mobileButtonIconTopMargin

Position fixe de l’icône des boutons de la barre d’outils, depuis le haut

mobileButtonIconWidth

Largeur de l’icône des boutons de la barre d’outils sur un périphérique mobile

mobileButtonIconHeight

Hauteur de l’icône des boutons de la barre d’outils sur un périphérique mobile

mobilefixedtoolbarbgcolor

Couleur d’arrière-plan de la barre d’outils sur un appareil mobile

Sur cette page