package HTML::FormHandler::Manual::Templates; # ABSTRACT: using templates __END__ =pod =head1 NAME HTML::FormHandler::Manual::Templates - using templates =head1 VERSION version 0.36000 =head1 SYNOPSIS Documentation on templates to use with L =head1 Using templates There is a FormHandler Template Toolkit rendering role at L
    , with a testcase in t/render_withtt.t.
    Normally, however, it probably won't make much sense to use both a
    TT parser in FormHandler, and a separate one for the "complete" templates,
    so it seems like the TT renderer would mainly be useful for tests,
    or as an example of how to do TT rendering with HFH.

    There are lots of different ways to set up templates. There are sample
    templates installed in FormHandler's 'share' directory. These templates
    are now organized more-or-less similarly to the widget roles, with 'field',
    'wrapper', and 'form' directories, but many other organizations are possible.

    Another organization would be to store all template snippets in a 'widget' directory.

    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 %]

    =head1 Field attributes

    If you want to use the 'process_attrs' function to pull in HTML attributes
    for the input elements, wrappers, and labels, you would need to pass that
    function into your TT setup. See L
     for an
    example:

        use HTML::FormHandler::Render::Util ('process_attrs');
        $c->stash( process_attrs => &process_attrs ); # or add to TT vars in your view

        label [% process_attrs(f.label_attributes) %]for="[% f.html_name %]">
        [% f.label %]:
=head1 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') %] =head2 Text input field with error class on div & error messages
[% IF f.has_errors %] [% FOR error IN f.errors %]

[% error %]

[% END %] [% END %] [% f.label %]
Simple text field; [% f = form.field('text_field') %]
[% f.label %]:
=head2 Select field Single select: [% f.label %]
Multiple select: [% f.label %]
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.) =head2 Checkbox
[% f.label %]:
=head2 Textarea
[% f.label %]:
    [% f.fif %]
=head2 Hidden
=head2 Submit
=head2 Radio group
[% f.label %] [% FOR option IN f.options %] [% option.label %]
[% END %]
=head1 AUTHOR FormHandler Contributors - see HTML::FormHandler =head1 COPYRIGHT AND LICENSE This software is copyright (c) 2012 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. =cut