Créer des styles CSS pour des formulaires HTML5 creating-css-styles-for-html-forms

CAUTION
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.

Le rendu HTML5 d’un modèle de formulaire basé sur XFA se compose de plusieurs éléments de HTML. Ces éléments sont organisés dans un ordre. Chaque élément comporte des classes CSS bien définies. Vous pouvez utiliser cette classe CSS pour sélectionner et modifier l’aspect d’un élément.

NOTE
Dans les classes CSS, ne modifiez pas la valeur des attributs de position et de taille : largeur, hauteur, épaisseur de bordure, haut, gauche, droite, bas, remplissage, marge. Toute modification des attributs de position et de taille modifie la disposition du formulaire.

Classes CSS pour les éléments  css-classes-nbsp-for-elements-nbsp

Chaque élément contient des classes CSS bien définies. Vous pouvez modifier ces classes pour modifier l’apparence d’un élément. Chaque élément, à l’exception des éléments de champ et de dessin, comporte deux classes CSS – Type et Nom.

  • Le type classe représente le type du champ XFA. Vous pouvez remplacer la classe type pour modifier les styles de tous les éléments d’un type donné.

  • Le nom de classe correspond au nom du champ XFA. Vous pouvez remplacer la classe name pour modifier un élément et lui appliquer un style personnalisé.

NOTE
Certains éléments XFA n’ont pas de nom. Pour modifier les styles de ces composants, modifiez tous les composants de ce type particulier.

Pour les pages non mentionnées dans AEM Forms Designer, les pages d’un formulaire HTML5 sont nommées dans l’ordre croissant de leur numéro. Par exemple, pour un formulaire HTML5 comportant deux pages, les pages sont nommées Page1 et Page2.

Elément de champ field-element

L’élément de champ contient deux éléments imbriqués : widget et légende.

Elément Widget

L’élément widget contient l’élément d’interface utilisateur pour l’interaction avec les utilisateurs. Il a trois classes CSS :

  • Widget  : chaque widget comporte cette classe.
  • nom  : tous les widgets fournis avec AEM contiennent la classe de nom widget. Pour les widgets personnalisés, le développeur de widgets fournit la classe de nom Widget.
  • type  : chaque widget comporte un élément d’interface utilisateur. Cette classe définit le type de l’élément d’interface utilisateur.
<!--field with caption-->
<div class="field numericfield NumericField3 ">
     <div class="caption">
        caption content
     </div>
     <div class="widget numericfieldwidget numericInput">
       widget content
     </div>
</div>

<!--field without caption-->
<div class="widget numericfieldwidget numericInput">
   widget content
</div>

Outre la classe de type et de nom, le composant de champ contient également une classe CSS supplémentaire nommée subtype. Un sous-type identifie le type de champ, par exemple NumericField, DateField, TextField. Vous pouvez remplacer la classe subtype pour modifier le style de tous les champs de type, sous-type.

Classes CSS des différents composants css-classes-for-different-components

Composant
Type
Nom
Page
page
Nom défini par l’utilisateur
ou
Page<pagenumber> (par défaut)
Zone de contenu
contentarea
Nom défini par l’utilisateur
Sous-formulaire
sous-formulaire
Nom défini par l’utilisateur
Groupe d’exclusion
exclgroup
Nom défini par l’utilisateur
Draw
draw
Nom défini par l’utilisateur
Champ
field
Nom défini par l’utilisateur
Légende
caption
s.o.
Widget
widget
Le développeur du widget le définit (pour les widgets définis par l’utilisateur, reportez-vous au tableau de la section suivante).

Classes CSS des différents champs css-classes-for-different-fields

AEM Forms Designer prend en charge différents types de champs d’un formulaire, tels que NumericField, DecimalField et le champ Date. Tous ces champs en HTML contiennent les classes CSS mentionnées ci-dessus. Elles contiennent également des classes supplémentaires en fonction du type de champ.

Chaque champ est associé à un widget représentant l’élément de l’interface utilisateur. Les classes de chaque champ et les widgets associés à chaque champ sont répertoriés ci-dessous.

Type de champ
Sous-type
Nom du widget
Type de widget
Balise d’interface utilisateur HTML
Bouton
s.o.
xfaButton
buttonfieldwidget
input type=button
CheckButton
checkboxfield
XfaCheckBox
checkboxfieldwidget
input type=checkbox
DateField
datefield
dateField
datefieldwidget
inputtype = text
DateTimeField
textfield
textField
textfieldwidget
inputtype = text
DecimalField
numericfield
numericInput
numericfieldwidget
inputtype = text
DropDown
choicelist
dropDownListWidget
choicelistwidget
select
ListBox
choicelist
listBoxWidget
choicelistwidget
ol
NumericField
numericfield
numericInput
numericfieldwidget
inputtype = text
PasswordField
passwordfield
defaultWidget
passwordfieldwidget
input type=password
RadioButton
radiofield
XfaCheckBox
radiofieldwidget
input type=radio
TextField
textfield
textField
textfieldwidget
inputtype = text
TimeField
textfield
textField
textfieldwidget
inputtype = text

Classes CSS des différents éléments de dessin css-classes-for-different-draw-elements

Vous pouvez insérer des éléments statiques de dessin comme un texte et des images à l’aide d’AEM Forms Designer. Pour chaque élément de dessin, une classe CSS distincte est associée à cet élément. La liste des classes CSS pour les éléments draw est ci-dessous. Chaque élément draw est associé à une classe draw.

Type de dessin
Classe CSS
Texte
text
Image
image
Rectangle
rectangle
Line
ligne

Style des autres parties du formulaire styling-other-parts-of-the-form

Outre l’aspect des composants de l’interface utilisateur dans le formulaire HTML, vous pouvez modifier le style des éléments comme les erreurs en ligne, les avertissements en ligne et les champs contenant des erreurs de validation.

Styling Inline Errors

Lorsque la validation d'un champ génère une erreur, une erreur insérée s'affiche lorsque le champ est principal. Pour modifier le style des erreurs intégrées, remplacez l’identifiant CSS. error-msg.

Styling Inline Warnings

Lorsque la validation d’un champ génère un avertissement, un avertissement intégré s’affiche lorsque le champ est principal. Pour modifier le style de ces avertissements intégrés, remplacez l’identifiant CSS. warning-msg.

Styling Fields with Validation Errors

Lorsque la fonction de validation d’un champ échoue, le style du widget change. Cette modification du style est effectuée en appliquant une classe CSS widgetError au composant widget. Pour modifier le style par défaut, remplacez la classe widgetError.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da