form.md

Form

Controls

• Vision\Control\Button
• Vision\Control\Checkbox
• Vision\Control\Color
• Vision\Control\Date
• Vision\Control\DateTime
• Vision\Control\DateTimeLocal
• Vision\Control\Email
• Vision\Control\File
• Vision\Control\Hidden
• Vision\Control\Image
• Vision\Control\Month
• Vision\Control\Number
• Vision\Control\Password
• Vision\Control\Radio
• Vision\Control\Range
• Vision\Control\Reset
• Vision\Control\Search
• Vision\Control\Select
• Vision\Control\Submit
• Vision\Control\Tel
• Vision\Control\Text
• Vision\Control\Textarea
• Vision\Control\Time
• Vision\Control\Url
• Vision\Control\Week

Usage

Create a basic form

use Vision\Form\Form;
use Vision\Form\Control\Email;
use Vision\Form\Control\Hidden;
use Vision\Form\Control\Text;
use Vision\Form\Control\Submit;

class ContactForm extends Form
{
    public function __construct($name)
    {
        parent::__construct($name);

        $firstName = new Text('firstName');

        $lastName = new Text('lastName');

        $email = new Email('email');

        $submit = new Submit('submit');
        $submit->setValue('Send');

        $this->addElements(array($firstName, $lastName, $email, $submit));
    }
}
$form = new ContactForm('contact-form');

// optional: pre-populate form controls
$form->setValues(array());

// optional: pre-populate form option controls (checkbox, select, radio)
$form->setOptions(array());

// input array (f.ex. $_POST or $_GET)
$data = array(
    'firstName' => 'Foo',
    'lastName' => 'Bar',
    'email' => '[email protected]',
)

$form->setData($data);

if ($form->isValid()) {
    // get validated values (after validators/filters were applied)
    print_r ($form->getValues());

    // or by element
    print ($form->getElement('firstName')->getValue());
} else {
    // get errors
    print_r ($form->getErrors());
}

Render a form

echo $form->start()
     . '<fieldset>'
     . $form->getElement('firstName')
     . $form->getElement('lastName')
     . $form->getElement('email')
     . $form->getElement('submit')
     . '</fieldset>'
     . $form->end();

Known issues and limitations

• No support for optgroup element.