jenwachter/html-form

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

0.6.1 2016-09-22 12:24 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