Étapes et pages
La structure q-stepper permet de construire un formulaire multi-étapes avec Quasar QStepper et un groupe FormKit par étape.
Réordonner les étapes
Deux emplacements proposent les mêmes actions :
- le panneau de configuration de l’étape ;
- l’onglet Arborescence du drawer gauche.
Les boutons Monter et Descendre modifient l’ordre de steps[]. L’étape déplacée reste sélectionnée et devient l’étape active.
Dupliquer une étape
L’action Dupliquer crée une copie immédiatement après l’étape source.
La duplication :
- copie la configuration de l’étape ;
- copie récursivement tous ses champs, sections, colonnes, onglets et structures imbriquées ;
- régénère tous les noms de champs pour éviter les collisions ;
- positionne l’état de validation de la copie sur
pending.
Supprimer une étape
L’action Supprimer est disponible dans le panneau de configuration et dans l’arborescence. La dernière étape ne peut pas être supprimée.
Après suppression, le builder sélectionne l’étape précédente, ou la première étape disponible.
États de validation
Chaque étape expose un statut partagé avec l’arborescence :
| État | Icône | Signification |
|---|---|---|
pending | horloge | Le groupe FormKit n’a pas encore produit d’état exploitable. |
valid | coche verte | Aucune erreur ni validation bloquante. |
invalid | erreur rouge | Au moins une règle de validation bloque la progression. |
Le statut apparaît :
- dans l’en-tête
QStepper; - dans la légende et l’icône du nœud d’étape dans
QTree.
Navigation bloquante
En mode aperçu ou dans FormViewer, l’utilisateur ne peut pas avancer tant que l’étape courante est invalide.
Le contrôle s’applique :
- au bouton Suivant ;
- à un clic direct sur une étape située plus loin dans l’en-tête du stepper.
Lorsqu’une navigation est refusée :
- l’étape est marquée comme soumise afin d’afficher les erreurs FormKit ;
- l’étape courante reste active ;
- une bannière indique de corriger les champs avant de continuer ;
- l’arborescence reçoit immédiatement le statut
invalid.
Le retour vers une étape précédente reste autorisé. Le mode édition du builder reste libre afin de permettre la conception du formulaire.
Conditions d’affichage
Une étape peut conserver une propriété if. En aperçu/runtime, les étapes dont la condition est fausse sont retirées de l’ordre de navigation. Le contrôle de progression utilise uniquement la liste des étapes visibles.