jenwachter/html-form

A PHP library designed to make creating, validating, and maintaining forms easier.

Installs: 893

Dependents: 0

Stars: 5

Watchers: 3

Forks: 3

Open Issues: 5

Language: PHP

0.3.2 2015-07-09 16:52 UTC

README

Hate writing and validating HTML forms? Me too. The HTML Form library was designed to make creating, validating, and maintaining forms easier.

Requirements

  1. PHP >= 5.3.2
  2. Sessions enabled (if you want the form fields to repopulate)

Installation

Via Composer:

{
    "require": {
        "jenwachter/html-form": "0.3.*"
    }
}

Documentation

See below for basic usage or see the wiki.

Basic Usage

// Create the form
$form = new \HtmlForm\Form();

// Add a fieldset
$fieldset = $form->addFieldset("Contact info");

// Add some form fields
$fieldset->addTextbox("name", "Your name", array("required" => true))
    ->addEmail("email", "Your email", array("required" => true))
    ->addNumber("age", "Your age")
    ->addSelect("gender", "Your gender", array("male", "female"));

$form->addSubmit("submit", "Submit");

// Render the form
$form->display();

// Validate the form
if (isset($_POST["submit"]) && $form->isValid()) {
    // continue processing the form as you see fit
}

Changelog

0.3.2
  • Removed rendering of global beforeElement and afterElement content before and after bits of HTML.
0.3.1
  • Bug fix
0.3
  • Added a flag that allows option form fields to use the numeric keys of the options array as the option field's value. Issue #13
0.2
  • HtmlForm\Form
    • render() is now display()
    • compileForm() is now render()
0.1
  • Initial release