depage-forms v1.4.1
html forms made easy
Loading...
Searching...
No Matches
steps.php

Steps example.

Steps exampleThis demonstrates dividing the form into separate pages using step container elements. As usual the form itself can only be valid when all its input elements are valid. It is also possible to attach input elements directly to the form (outside any step container). These elements are visible on every step.

<?php
/*
* Load the library...
*/
require_once '../../HtmlForm.php';
/*
* Create the example form 'stepsExampleForm'
*/
$form = new Depage\HtmlForm\HtmlForm('stepsExampleForm', [
'backLabel' => "back",
]);
/*
* add (optional) step navigation
*/
$form->addStepNav();
/*
* Create the first step.
*/
$firstStep = $form->addStep('firstStep', ['label' => "1. First step"]);
/*
* Attach the first text input element
*/
$firstStep->addText('text1', ['label' => 'First step text field', 'required' => true]);
/*
* And so on...
*/
$secondStep = $form->addStep('secondStep', ['label' => "2. Second step"]);
$secondStep->addText('text2', ['label' => 'Second step text field', 'required' => true]);
$thirdStep = $form->addStep('thirdStep', ['label' => "3. Third step"]);
$thirdStep->addText('text3', ['label' => 'Third step text field', 'required' => true]);
/*
* The process method is essential to the functionality of the form. It serves
* various purposes:
* - it validates submitted data if there is any
* - it redirects to the success page if all the data is valid
* - it stores the data in the session and redirects to the form to circumvent
* the form resubmission problem
* - this is also where the form decides which step to display
*/
$form->process();
/*
* Finally, if the form is valid, dump the data (for demonstration). If it's
* not valid (or if it hasn't been submitted yet) display the current step.
*/
if ($form->validate()) {
/*
* Success, do something useful with the data and clear the session.
*/
echo('<a href="steps.php">back</a>');
echo('<pre>');
var_dump($form->getValues());
echo('</pre>');
$form->clearSession();
} else {
/*
* Display the form (current step).
*/
?>
<!DOCTYPE html>
<head>
<link rel="stylesheet" type="text/css" href="../../lib/css/depage-forms.css">
</head>
<body>
<?php echo($form); ?>
</body>
<?php
}
Depage\HtmlForm\HtmlForm
main interface to users
Definition HtmlForm.php:124