Assistants de formulaire multi-étapes

Transformez un long formulaire de création/édition en un assistant guidé étape par étape, au-dessus du même unique enregistrement.

form_wizard() - déclarer une étape par appel

->form_wizard($fields, $label, $options = []) déclare une étape ; appelez-la une fois par étape, dans l'ordre où les étapes doivent apparaître. Un assistant n'est qu'une couche de présentation côté client au-dessus du même unique enregistrement que tout autre formulaire utilise - le bouton Enregistrer n'apparaît que sur la dernière étape. Il est mutuellement exclusif avec ->fields()/->fields_arrange() comme disposition de formulaire de premier niveau.

$xcrud->form_wizard('firstName,lastName,email', 'Contact Info');
$xcrud->form_wizard('addressLine1,city,postalCode', 'Address', ['desc' => 'Where should we ship?']);
$xcrud->form_wizard('cardNumber,expiry', 'Payment');

Paramètre	Type	Défaut	Description
`$fields`	`string\|array`	-	Chaîne séparée par des virgules ou tableau de noms de champs pour cette étape ; un champ ne peut apparaître que dans une seule étape
`$label`	`string`	-	Nom de l'étape affiché dans l'indicateur de progression
`$options`	`array`	`[]`	`desc`, `next`, `previous` - voir ci-dessous

Clé d'option	Type	Description
`desc`	`string`	Une courte phrase affichée sous le nom de l'étape
`next`	`string`	Libellé du bouton suivant propre à cette étape, remplaçant le `next_label` global
`previous`	`string`	Libellé du bouton précédent propre à cette étape, remplaçant le `previous_label` global

form_wizard_settings() - apparence globale

->form_wizard_settings($settings) configure l'apparence et le comportement d'ensemble de l'assistant. Appelez-la une fois, n'importe où après les déclarations form_wizard(). Toute clé omise conserve sa valeur par défaut.

$xcrud->form_wizard_settings([
    'progress' => 'step',
    'next_label' => 'Continue',
    'previous_label' => 'Back',
    'done_label' => 'Submit',
    'validate_step' => true,
]);

Réglage	Type	Défaut	Description
`progress`	`string`	`'step'`	Voir les 4 styles de progression ci-dessous
`next_label`	`string`	`'Next'`	Texte du bouton suivant
`previous_label`	`string`	`'Back'`	Texte du bouton précédent
`done_label`	`string`	Le texte d'enregistrement propre à la page	Texte du bouton sur l'action de soumission de la dernière étape
`show_step_numbers`	`bool`	`true`	Afficher la pastille "Étape N sur M" / numérique
`show_step_desc`	`bool`	`true`	Afficher le `desc` de chaque étape sous son libellé
`validate_step`	`bool`	`true`	Exécuter la validation HTML5 native avant de passer à l'étape suivante, bloquant le passage si invalide

Style de progression	Apparence
`step`	Indicateurs numérotés "Étape N sur M" avec libellés
`pill`	Boutons de type nav-pill avec une coche sur les étapes visitées
`bar`	Une seule barre de progression horizontale, remplie jusqu'à l'étape actuelle
`none`	Aucun indicateur de progression, juste Précédent/Suivant

Un exemple complet en 3 étapes

$xcrud = Xcrud::get_instance();
$xcrud->table('customers');
$xcrud->route('customers');

$xcrud->form_wizard('customerName,contactFirstName,contactLastName', 'Company');
$xcrud->form_wizard('addressLine1,city,country,postalCode', 'Address');
$xcrud->form_wizard('phone,creditLimit', 'Account Terms');

$xcrud->form_wizard_settings([
    'progress' => 'pill',
    'done_label' => 'Create Customer',
]);

$xcrud->render();