/ 
HTML-FormHandler-0.32004
River stage two • 21 direct dependents • 31 total dependents
/ HTML::FormHandler::Manual::Templates

NAME

HTML::FormHandler::Manual::Templates - using templates

VERSION

version 0.32004

SYNOPSIS

Documentation on templates to use with HTML::FormHandler

Using templates

There are lots of different ways to set up templates. One way is to create a 'widget' directory, and store template snippets there.

You can use the default 'widget' for the field class, or set the 'widget' for the field in your form:

fields => [
   my_special_field => {
      type => 'Text',
      widget => 'my_special_widget',
   },
   my_second_field => {
      type => 'Text',
      widget => 'yet_another_widget',
   },
]

And include them in a generic template:

[% PROCESS widget/form_start.tt %]

[% FOREACH f IN form.sorted_fields %]
   [% PROCESS widget/${f.widget}.tt %]
[% END %]

[% PROCESS widget/form_end.tt %]

Sample templates

Note that the following templates assume that the field is in a TT variable "f", as though they were processed in the above loop. Otherwise the individual fields could be preceded by something like:

[% f = form.field('title') %]

Text input field with error class on div & error messages

<div class="[% f.css_class %] [% IF f.has_errors %]error_fld[% END %]">
[% IF f.has_errors %]
  [% FOR error IN f.errors %]
    <p><span class="error" id="error">[% error %] </span></p>
  [% END %]
[% END %]
<label class="label" for="[% f.id %]">[% f.label %]</label>
<input type="text" name="[% f.html_name %]" id="[% f.id %]" value="[% f.fif %]">
</div>

Simple text field;

[% f = form.field('text_field') %]
<div><label class="label" for="[% f.id %]">[% f.label %]: </label>
<input type="text" name="[% f.html_name %]" id="[% f.id %]" value="[% f.fif %]" /> </div>

Select field

Single select:

<label class="label" for="[% f.id %]">[% f.label %]</label>
<select name="[% f.html_name %]" id="[% f.id %]>
  [% FOR option IN f.options %]
    <option value="[% option.value %]"
    [% IF option.value == f.fif %]
       selected="selected"
    [% END %]>
    [% option.label %]</option>
  [% END %]
</select>

Multiple select:

<label class="label" for="[% f.id %]">[% f.label %]</label>
<select name="[% f.html_name %]" id="[% f.id %]
          multiple="multiple" size="[% f.size %]">
  [% FOR option IN f.options %]
    <option value="[% option.value %]"
    [% FOREACH optval IN f.value %]
       [% IF optval == option.value %]
          selected="selected"
       [% END %]
    [% END %]>
    [% option.label %]</option>
  [% END %]
</select>

Warning: TT has problems with single element arrays. If you are likely to have a single element in a select list, you might want to use the rendering method instead or add an extra "choose" row. (If you come up with a good solution, please submit a doc patch.)

Checkbox

<div><label class="label" for="[% f.id %]">[% f.label %]: </label>
<input type="checkbox" name="[% f.html_name %]" id="[% f.id %]" value="1" />
</div>

Textarea

<div><label class="label" for="[% f.id %]">[% f.label %]" </label>
<textarea name="[% f.html_name %]" id="[% f.id %]"
     rows="[% f.rows %]" cols="[% f.cols %]">[% f.fif %]</textarea></div>

Hidden

<div><input type="hidden" name="[% f.html_name %]" id="[% f.id %]"
    value="[% f.fif %]" /></div>

Submit

<div><input type="submit" name="[% f.html_name %]" id="[% f.id %]"
    value="[% f.value %]" /></div>

Radio group

<div>
<label class="label" for="[% f.id %]">[% f.label %]</label>
[% FOR option IN f.options %]
  <input type="radio" value="[% option.value %]"
     name="[% f.name %]"
  [% IF option.value == f.fif %]
     checked="checked"
  [% END %]>
  [% option.label %]<br />
[% END %]
</div>

AUTHOR

FormHandler Contributors - see HTML::FormHandler

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Gerda Shank.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.