NAME

HTML::FormHandler::Render::Simple - Simple rendering routine

SYNOPSIS

This is a Moose role that is an example of a very simple rendering routine for HTML::FormHandler. It has almost no features, but can be used as an example for producing something more complex. The idea is to produce your own custom rendering roles...

In your Form class:

   package MyApp::Form::Silly;
   use Moose;
   extends 'HTML::FormHandler::Model::DBIC';
   with 'HTML::FormHandler::Render::Simple';

In a template:

   [% form.render %]

or for individual fields:

   [% form.field_render( 'title' ) %]

DESCRIPTION

This role provides HTML output routines for the 'widget' types defined in the provided FormHandler fields. Each 'widget' name has a 'widget_$name' method here.

These widget routines output strings with HTML suitable for displaying form fields.

The widget for a particular field can be defined in the form. You can create additional widget routines in your form for custom widgets.

render

To render all the fields in a form in sorted order (using 'sorted_fields' method).

render_field

Render a field passing in a field object or a field name

   $form->render_field( $field )
   $form->render_field( 'title' )

render_text

Output an HTML string for a text widget

render_password

Output an HTML string for a password widget

render_hidden

Output an HTML string for a hidden input widget

render_select

Output an HTML string for a 'select' widget, single or multiple

render_checkbox

Output an HTML string for a 'checkbox' widget

The equivalent of:

render_radio_group

Output an HTML string for a 'radio_group' selection widget. This widget should be for a field that inherits from 'Select', since it requires the existance of an 'options' array.

render_textarea

Output an HTML string for a textarea widget

render_compound

Renders field with 'compound' widget

render_submit

Renders field with 'submit' widget

AUTHORS

Gerda Shank, gshank@cpan.org

COPYRIGHT

This library is free software, you can redistribute it and/or modify it under the same terms as Perl itself.

cpanm HTML::FormHandler

perl -MCPAN -e shell
install HTML::FormHandler