Form generation and building
Form generation and building.
This package will replace the default Fieldset class provided by the FuelPHP v1.x core by the FuelPHP v2.0 fieldset package.
$ composer require fuelphp/fieldset
Once the package reaches a suitable milestone a tagged release will be created.
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 classes exist.
Grouped check boxes and radio buttons now have their own logic for repopulation and naming when used in groups, hence the
Select elements are comprised of
For more info on check box/radio groups and selects please see here.
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
BasicRender 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\BasicRender; $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
BasicRender 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!
Fieldset comes with a couple of basic renderes, a generic one that does not add any formatting or css and a Bootstrap3 based renderer that will build forms that are compatible with the Bootstrap CSS framework.