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...

You are advised to create a copy of this module for use in your forms, since it is not possible to make improvements to this module and maintain backwards compatibility.

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.render_field( '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_start, render_end

Will render the beginning and ending <form> tags and fieldsets. Allows for easy splitting up of the form if you want to hand-render some of the fields.

   [% form.render_start %]
   [% form.render_field('title') %]
   <insert specially rendered field>
   [% form.render_field('some_field') %]
   [% form.render_end %]

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

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

See CONTRIBUTORS in HTML::FormHandler

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