PEAR Manual
Prev |  | Next

# Usage examples

Usage examples -- Using HTML_Form.

## Creating the form in "table mode"

Creating a form in "table mode" means that the package returns the complete form in a fixed width table. Whilst this does not work very well for most frontend websites, it is a very convenient way to create forms during development phase or for backend systems where the design does not matter (much).

Example 41-1. Creating a form
    require_once "HTML/Form.php";

    $form = new HTML_Form('receivingscript.php');

    $form->addText("name", "What's your name?");
    $form->addText("email", "What's your email address?");
    $form->addPassword("password", "Please enter the desired password");
    $form->addPlaintext("Tip", "Your password should be hard to guess");
    $form->addSubmit("submit", "Submit");

    $form->display();

This will display a table where the left column holds the labels of the different fields. In the right column the different fields are placed.

## Displaying single form tags

Apart from retrieving the table as a whole, one can also use the API of HTML_Form to directly display single form tags.

Example 41-2. Directly displaying form tags
    require_once "HTML/Form.php";

    $form = new HTML_Form('receivingscript.php');

    $form->displayText("name", "What's your name?");

The above example will print the HTML markup being necessary to render a text input field. It will not print the surrounding `<form />` tag or something else!

## Returing single form tags

Similar to displaying form tags with the display*() functions HTML_Form can also return the tag instead of printing it.

Example 41-3. Returning form tags
    require_once "HTML/Form.php";

    $form = new HTML_Form('receivingscript.php');

    $str = $form->returnPassword("password", "Choose a password");

The variable `$str` now contains HTML markup like `<input type="password" name="password" />`.

Prev | Home | Next
Introduction | Up | HTML_Menu