elvenspellmaker / fieldset

FuelPHP Framework - Form Builder library

Fuel Fieldset Package

This package will replace the default Fieldset class provided by the FuelPHP v1.x core by the FuelPHP v2.0 fieldset package.

Installing

Simply add "fuelphp/fieldset": "dev-master" to your composer.json and install. Once the package reaches a suitable milestone a tagged release will be created.

Getting started

Forms are created by first creating a container object, a Form or a Fieldset. You can then add Inputs to these containers.

<?php

use Fuel\Fieldset\Form;
use Fuel\Fieldset\Input;

$form = new Form;

$form[] = new Input\Text('name');
$form[] = new Input\Submit('submit', [], 'GO!');

//This will repopulate the form with any submitted data
$form->repopulate();

//This will repopulate the form with the given data, the flag indicates wether to call `repopulate()` after or not
$form->populate($myData, true);

InputElement types

The current InputElement classes exist.

• Button
• Checkbox
• CheckboxGroup
• Email
• File
• Hidden
• Optgroup
• Option
• Password
• Radio
• RadioGroup
• Reset
• Select
• Submit
• Text
• Textarea

Grouped check boxes and radio buttons now have their own logic for repopulation and naming when used in groups, hence the ChecboxGroup and RadioGroup classes. Select elements are comprised of Options and Optgroups. For more info on check box/radio groups and selects please see here.

Showing the form

Unlike v1 fieldsets a totally separate class is used to create the html for the form. Whilst each InputElement knows how to display itself in the most basic form the use of a Renderer allows for more complex behaviour to be achieved. This can include things such as generating the form in a table or as a list. By default SimpleRender will render the form in a table, much the same as the v1 fieldsets did. In the future other basic renderers might be added to the package to support things like list based forms out of the box. Pull/merge requests are always welcome.

The render classes are all used in the same basic way:

<?php

use Fuel\Fieldset\Render;

$engine = new BasicRender();

$formHtml = $engine->render($form);

It is easily possible to create your own renderer if the default one does not suit your needs. For an example take a look at the SimpleRender code and additionally here. If you do make your own renderer for a UI kit or css framework then please consider submitting a pull request!