nicolas-brousse/paris-form-helper

Form helper for Paris ORM inspired by ActiveView::Helpers::FormHelper

Paris Form Helper

Form helper for Paris ORM and inspired by ActiveView::Helpers::FormHelper.
It can be use without Paris., _(*1)

Example

A Paris Model, _(*2)

create(); ?>
...
array('class' => 'form'))) ?>

  = $form->label('title') ?><br />
  = $form->text_field('title') ?>

  = $form->label('content') ?><br />
  = $form->text_area('content', array('cols' => 50, 'rows' => 4)) ?>

  = $form->label('author') ?><br />
  = $form->text_area('author', array('class' => 'author-input')) ?>

  = $form->label('is_publish') ?><br />
  = $form->text_area('is_publish', array('check_value' => 'yes', 'uncheck_value' => 'no')) ?>

How use it?

Start the form

To start the form use Helpers_Form::form_for($model, $form_action, array $options).
$model: the model to use for the form. So form values ares automaticaly setted. It can be null for standalone forms.
$form_action: url to send the datas.
$options: the options of the forms. The options are: * method: to precise the form method (post|get). Note: if you use Paris Model method are auto-setted post if the model is new and put for edition. * html: to add attributes on <form /> tag. And it return the instance of the form. It necessary to access the form helper methods., _(*3)

To close the form use Helpers_Form::end_form_for() for print it., _(*4)

Label

$form->label(string $name [ string $label, [, array $attributes [, array $options ]]]), _(*5)

Inputs

List of inputs: checkbox - email - hidden - password - text, _(*6)

Hidden

Text

$form->text_field(string $name [, array $attributes [, array $options ]]), _(*7)

Email

$form->email_field(string $name [, array $attributes [, array $options ]]), _(*8)

Password

$form->password_field(string $name [, array $attributes [, array $options ]]), _(*9)

Checkbox

$form->checkbox(string $name [, array $attributes [, array $options ]]), _(*10)

TextArea

$form->textarea(string $name [, array $attributes [, array $options ]]), _(*11)

Submit

$form->submit(string $label [, array $attributes ]), _(*12)