Cascade Select
Cascade Select sélectionne un chemin dans des options hiérarchiques. Le champ appartient à l’état, à la validation et au périmètre de soumission du formulaire.
1. Cas d’utilisation
Usages courants :
- Pays, région et ville
- Chemins de catégories produit
- Domaines et sous-domaines métier
2. Ajouter et configurer
- Ajoutez Cascade Select dans la zone Fields d’une Form Section.
- Définissez un Field Key / Name stable et unique, identique à la propriété du DTO backend.
- Configurez les propriétés ci-dessous, puis Required, Help Text, Full row ou les conditions selon le besoin.
- Vérifiez la valeur initiale et la mise en page dans Design Preview, puis testez le parcours avec Validate / Submit.
3. Propriétés principales
| Propriété | Rôle |
|---|---|
| Options | Définit la source des données sélectionnables et leur mappage. |
| Model Relation Data Source | Définit la source des données sélectionnables et leur mappage. |
| Enable Search | Active ou désactive ce comportement. |
| Parent Selectable | Active ou désactive ce comportement. |
| Required | Active ou désactive ce comportement. |
Les propriétés communes Field Key, Required, Help Text, Full row et Visible When proviennent du contrat de champ Form. Le tableau met en avant les réglages propres à Cascade Select.
4. Valeur du formulaire et contrat backend
Valeur soumise : Un tableau de valeurs de la racine à la feuille sélectionnée.
["canada", "ontario", "toronto"]
L’exemple montre uniquement la forme des données. L’API doit toujours valider le type, les limites et les autorisations du DTO métier.
5. Validation, conditions et interactions
Tous les champs peuvent utiliser Required, Visible When, Disabled When, Required When, Dependencies et Clear When Hidden. Ces conditions améliorent l’interface mais ne remplacent jamais la validation ni les autorisations du backend.
Capacités du composant : Prend en charge onChange afin de poursuivre une Page Interaction après la sélection.
6. Recommandations
Conseils : Conservez des valeurs stables pour les enums ou identifiants backend. Les libellés peuvent être traduits mais ne sont pas des clés métier.
Revenez à la présentation de Form pour la mise en page, la validation, la soumission, les brouillons et le protocole backend.