Composant des options de formulaire form-options-component

Le composant des options de formulaire des composants principaux permet la sélection d’options prédéfinies dans divers formats.

Utilisation usage

Le composant des options de formulaire des composants principaux permet l’envoi de différents types d’options présentés de différentes manières. Il est destiné à être utilisé avec le composant de conteneur de formulaires.

La présentation des options, des étiquettes et des options individuelles peut être définie par l’éditeur de contenu dans la boîte de dialogue de configuration.

Version et compatibilité version-and-compatibility

La version actuelle du composant des options de formulaire est v2, qui a été introduite avec la version 2.0.0 des composants principaux en janvier 2018. Elle est décrite dans ce document.

Le tableau ci-après présente en détail toutes les versions prises en charge du composant, les versions AEM avec lesquelles les versions du composant sont compatibles et les liens vers la documentation pour les versions précédentes.

Version du composant
AEM 6.4
AEM 6.5
AEM as a Cloud Service
v2
Compatible avec la
version 2.17.4 et versions antérieures.
Compatible
Compatible
v1
Compatible
Compatible
Compatible

Pour plus d’informations sur les versions et les publications des composants principaux, voir le document sur les versions des composants principaux.

Exemple de sortie de composant sample-component-output

Pour tester le composant des options de formulaire et obtenir des exemples d’options de configuration, ainsi que des sorties HTML et JSON, consultez la bibliothèque de composants.

Détails techniques technical-details

La documentation technique la plus récente sur le composant Options du formulaire se trouve sur GitHub.

Vous trouverez plus d’informations sur le développement des composants principaux dans la documentation destinée aux développeurs de composants principaux.

Boîte de dialogue de configuration configure-dialog

La boîte de dialogue de configuration permet à l’auteur de contenu de définir le type d’options qui doit être présenté, les étiquettes et les options disponibles.

Boîte de dialogue de modification du composant Options du formulaire

  • Types  : présentation des options.

    • Cases à cocher
    • Boutons radio
    • Liste déroulante
    • Liste déroulante à sélection multiple
  • Titre  : titre qui s’affiche comme libellé pour les options.

  • Nom  : nom du champ qui est envoyé avec les données de formulaire.

  • Source  : emplacement de définition des options.

    • Local  : défini dans le composant.

      • Appuyez ou cliquez sur le bouton Ajouter pour ajouter une valeur. Sinon, appuyez ou cliquez sur Supprimer pour supprimer une valeur.

        • Valeur  : valeur enregistrée lorsque cette option est sélectionnée lors de l’envoi du formulaire.
        • Texte  : libellé de l’option affichée sur le formulaire.
        • En cours  : l’option est marquée comme étant sélectionnée lors du chargement du formulaire.
        • Désactivé  : l’option n’est pas sélectionnable mais toujours affichée.
    • Liste  : liste statique définie ailleurs dans AEM et utilisée pour les options.

      • Liste  : chemin d’accès à la liste statique dans AEM.
        • Utilisez le bouton Parcourir pour localiser la ressource de liste.
    • Source de données  : une source de données est utilisée pour les options.

      • Source de données  : type de ressource de la source de données.
  • Message d’aide  : conseil à l’intention de l’utilisateur sur ce qui peut être entré dans le champ.

  • ID  : cette option permet de contrôler l’identifiant unique du composant dans le code HTML ainsi que dans la couche de données.

    • Si rien n’est indiqué, un ID unique est généré automatiquement et peut être trouvé en examinant la page obtenue.
    • Si un ID est spécifié, il incombe à l’auteur de s’assurer qu’il est unique.
    • La modification de l’ID peut avoir un impact sur le suivi CSS, JS et de couche de données.

Boîte de dialogue de conception design-dialog

Onglet Styles styles-tab

Le composant des options de formulaire prend en charge le système de style AEM.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c