Multi-Row Input
Multi-Row Input édite un tableau d’objets avec des lignes ajoutables ou supprimables. Le champ appartient à l’état, à la validation et au périmètre de soumission du formulaire.
1. Cas d’utilisation
Usages courants :
- Contacts d’urgence
- Lignes de commande ou de frais
- Collection bornée d’enregistrements répétés
2. Ajouter et configurer
- Ajoutez Multi-Row Input 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 |
|---|---|
| Fields | Définit la forme des données de liaison, de soumission ou de réponse. |
| Max Rows | Limite le nombre, la longueur ou la plage de valeurs. |
| Show Label / Show Header | Contrôle l’affichage du champ dans Design Preview et Runtime. |
| Table Layout | Contrôle l’affichage du champ dans Design Preview et Runtime. |
| Hide New / Hide Delete | Active ou désactive ce comportement. |
| Validator | Définit la forme des données de liaison, de soumission ou de réponse. |
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 à Multi-Row Input.
4. Valeur du formulaire et contrat backend
Valeur soumise : Un tableau d’objets dont les propriétés proviennent des Field Keys enfants.
[
{"name": "Alex", "relationship": "Manager", "phone": "+1 555 0100"}
]
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 setValue pour écrire la valeur depuis un bouton, une Step ou une autre action.
6. Recommandations
Conseils : Stabilisez d’abord le contrat JSON, puis testez de bout en bout les éléments, métadonnées de fichier et erreurs serveur.
Revenez à la présentation de Form pour la mise en page, la validation, la soumission, les brouillons et le protocole backend.