HTML::FormHandler::ManUser:Contributed)HTML::FormHandler::Manual::Templates(3)NAMEHTML::FormHandler::Manual::Templates - using templates
VERSION
version 0.35005
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) 2011 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.
perl v5.14.12011-HTML::FormHandler::Manual::Templates(3)
