Version et compatibilité

Le composant principal Liste déroulante des formulaires adaptatifs a été publié en février 2023 au sein des composants principaux 2.0.4 pour Cloud Service et des composants principaux 1.1.12 pour AEM 6.5.16.0 Forms ou version ultérieure. Vous trouverez ci-dessous un tableau détaillant les versions prises en charge, la compatibilité avec AEM et les liens vers la documentation correspondante :

Version du composantAEM as a Cloud ServiceAEM 6.5.16.0 Forms ou version ultérieure
v1Compatible avec la
version 2.0.4 et les versions ultérieures
Compatible avec les
versions 1.1.12 à 2.0.0 exclue.

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

Détails techniques

Retrouvez les informations les plus récentes sur le composant principal « Liste déroulante » des formulaires adaptatifs dans la documentation technique sur GitHub. Pour plus d’informations sur le développement des composants principaux, consultez la Documentation destinée aux développeurs et développeuses de composants principaux.

Boîte de dialogue de configuration

Vous pouvez facilement personnaliser l’expérience des visiteurs et des visiteuses en matière de liste déroulante en utilisant la boîte de dialogue Configurer. Vous pouvez également définir facilement des options de liste déroulante pour une expérience utilisateur fluide.

Onglet de base

Onglet De base

  • Nom - Vous pouvez identifier facilement un composant de formulaire en lui attribuant un nom unique dans le formulaire et dans l’éditeur de règles, mais le nom ne doit pas contenir d’espaces ni de caractères spéciaux.

  • Titre - Avec son titre, vous pouvez facilement identifier un composant dans un formulaire. Par défaut, le titre s’affiche au-dessus du composant. Si vous n’ajoutez pas de titre, le nom du composant s’affiche à la place du texte du titre.

  • Autoriser le texte enrichi pour le titre - Cette fonctionnalité permet aux personnes de mettre en forme les titres en texte brut en y incorporant des fonctionnalités telles que le texte en gras, en italique et souligné, diverses polices, tailles de police et couleurs, et d’autres options pour améliorer la présentation visuelle et la personnalisation. Elle offre une plus grande flexibilité et un contrôle créatif pour faire ressortir les titres dans les documents, sites web ou applications.
    Lorsque vous cochez la case Autoriser le texte enrichi pour le titre, les options de formatage deviennent visibles pour appliquer un style au titre du composant. Pour accéder à toutes les options de formatage disponibles, vous pouvez cliquer sur l’onglet Fullscreen icon .

    Prise en charge de texte enrichi

  • Masquer le titre - Sélectionnez cette option pour masquer le titre du composant.

  • Autoriser la sélection multiple - Sélectionnez cette option pour sélectionner plusieurs options dans une liste déroulante.

  • Enregistrer la valeur sous - Cette option spécifie le type de données de la valeur envoyée lorsqu’une option est sélectionnée. Si Enregistrer la valeur sous est défini sur Number et que vous ajoutez des données de chaîne à Valeur des données dans l’onglet Options, l’écran affiche un message d’erreur Value type mismatch.

    Dans l’onglet Options, vous pouvez ajouter des valeurs de données et afficher des paires de texte à l’aide du bouton Ajouter. Une fois qu’une nouvelle option est ajoutée, les actions suivantes sont effectuées :

    • Valeur des données - Cette option permet de saisir le contenu à envoyer lorsqu’une option est sélectionnée.
    • Texte d’affichage - Cette option permet de saisir le contenu à afficher dans un formulaire adaptatif.
    • Supprimer - Appuyez ou cliquez sur supprimer pour supprimer l’option d’un menu déroulant.
    • Réorganiser - Appuyez ou faites glisser pour réorganiser l’ordre de l’option d’un menu déroulant.
  • Option par défaut - Cette option vous permet d’ajouter des valeurs par défaut. Utilisez l’icône Supprimer pour supprimer l’option ajoutée. Si Enregistrer la valeur sous est défini sur Number et que vous ajoutez des données de chaîne à Options par défaut, l’écran affiche un message d’erreur Value type mismatch.

  • Texte d’espace réservé - Le texte d’espace réservé dans un composant de formulaire fait référence à un libellé court ou à une invite qui apparaît dans un champ de saisie comme conseil à l’utilisateur ou à l’utilisatrice sur le type d’information à saisir dans ce champ. Le texte d’espace réservé disparaît lorsque l’utilisateur ou l’utilisatrice commence à saisir du texte dans le champ et réapparaît si le champ est vide. Il fournit un indice visuel à l’utilisateur ou à l’utilisatrice, mais n’agit pas comme une valeur ou un libellé permanent pour le champ.

  • Options - Vous pouvez ajouter des valeurs de données et des paires de texte d’affichage à l’aide du bouton Ajouter. Lorsqu’une nouvelle option est ajoutée, les actions suivantes peuvent être effectuées :

    • Valeur des données - Cette option permet de saisir le contenu à envoyer lorsqu’une option est sélectionnée.
    • Texte d’affichage - Cette option permet de saisir le contenu à afficher dans un formulaire adaptatif.
    • Supprimer - Appuyez ou cliquez sur supprimer pour supprimer l’option d’une case à cocher.
    • Réorganiser : Appuyez ou cliquez et faites glisser pour réorganiser l’ordre des panneaux.
  • Référence Bind - Une référence Bind est une référence à un élément de données stockée dans une source de données externe et utilisée dans un formulaire. La référence de liaison vous permet de lier dynamiquement les données aux champs du formulaire, de sorte que le formulaire puisse afficher les données les plus récentes de la source de données. Par exemple, une référence de liaison peut être utilisée pour afficher le nom et l’adresse d’un client ou d’une cliente dans un formulaire, en fonction de l’identifiant du client ou de la cliente saisi dans le formulaire. La référence de liaison peut également être utilisée pour mettre à jour la source de données avec les données saisies dans le formulaire. Ainsi, AEM Forms vous permet de créer des formulaires qui interagissent avec des sources de données externes, offrant ainsi une expérience utilisateur fluide pour la collecte et la gestion des données.

  • Marquer comme élément de formulaire non lié : sélectionnez cette option pour configurer un champ de formulaire qui n’est lié à aucun schéma. Cette option vous permet d’enregistrer des données sans mettre à jour la source de données. Elle vous permet également de gérer les données de manière personnalisée, en les séparant de l’intégration de base de données standard.

  • Masquer le composant - Sélectionnez cette option pour masquer le composant du formulaire. Le composant reste accessible à d’autres fins, par exemple pour les calculs dans l’éditeur de règles. Cela s’avère utile lorsque vous devez stocker des informations qui n’ont pas besoin d’être affichées ou directement modifiées par les utilisateurs ou les utilisatrices.

  • Désactiver le composant - Sélectionnez cette option pour désactiver le composant. Le composant désactivé n’est pas actif ni modifiable par l’utilisateur final ou l’utilisatrice finale. L’utilisateur ou l’utilisatrice peut voir la valeur du champ mais ne peut pas la modifier. Le composant reste accessible à d’autres fins, par exemple pour les calculs dans l’éditeur de règles.

  • Lecture seule - Sélectionnez cette option pour rendre le composant non modifiable. L’utilisateur ou l’utilisatrice peut voir la valeur du champ mais ne peut pas la modifier. Le composant reste accessible à d’autres fins, par exemple pour les calculs dans l’éditeur de règles.

Onglet Validation

Onglet Validation

  • Obligatoire : Sélectionnez cette option si vous souhaitez afficher le composant dans un formulaire adaptatif. Après avoir sélectionné cette option, vous devez effectuer une sélection avant de poursuivre l’envoi du formulaire. Vous ne pouvez pas sélectionner Masquer le composant ou Désactiver le composant dans l’onglet De base lorsque cette option est sélectionnée.

  • Message d’erreur : cette option vous permet de rédiger un message qui s’affiche si la case à cocher Obligatoire est activée et le champ de formulaire reste vide.

  • Message de validation de script : cette option permet de saisir un message à afficher en cas d’échec de la validation du script.

Onglet Contenu de l’aide

Onglet Contenu d’aide

  • Description courte : Une description courte est une brève explication textuelle qui fournit des informations supplémentaires ou une clarification sur l’objectif d’un champ de formulaire spécifique. Il permet à l’utilisateur ou l’utilisatrice de comprendre le type de données à saisir dans le champ et peut fournir des conseils ou des exemples pour s’assurer que les informations saisies sont valides et répondent aux critères souhaités. Par défaut, les descriptions courtes restent masquées. Activez l’option Toujours afficher une description courte pour l’afficher sous le composant.

  • Toujours afficher une description courte - Activez cette option pour afficher la description courte sous le composant.

  • Texte d’aide - Le texte d’aide fait référence à des informations ou des conseils supplémentaires fournis à l’utilisateur ou à l’utilisatrice pour l’aider à remplir correctement un champ de formulaire. Il s’affiche lorsque l’utilisateur ou l’utilisatrice clique sur l’icône d’aide (i) placée à côté du composant. Le texte d’aide fournit des informations plus détaillées que le texte du libellé ou de l’espace réservé d’un champ de formulaire. Il est conçu pour aider l’utilisateur ou l’utilisatrice à comprendre les exigences ou les contraintes du champ. Il peut également proposer des suggestions ou des exemples pour faciliter le remplissage du formulaire et le rendre plus précis.