NAME

       HTML::FormHandler::Blocks - arrange form layout using blocks

VERSION

       version 0.40068

SYNOPSIS

       This is a role which provides the ability to render your form in arbitrary 'blocks', instead of by
       fields. This role is included by default in HTML::FormHandler.

           package MyApp::Form;
           use HTML::FormHandler::Moose;
           extends 'HTML::FormHandler';

           sub build_render_list {[ 'foo', 'fset' ]}
           has_field 'foo';
           has_field 'bar';
           has_field 'nox';
           has_block 'fset' => ( tag => 'fieldset', render_list => ['bar', 'nox'] );;
           ....
           $form->render;

       Blocks live in the HTML::FormHandler::Widget::Block:: namespace. The default, non-typed block is
       HTML::FormHandler::Widget::Block. Provide a type for custom blocks:

           has_block 'my_block' => ( type => 'CustomBlock', render_list => [...] );

       You can also build blocks with a 'block_list' attribute, or the builder for it, 'build_block_list'.

       Rendering with blocks is supported by the rendering widgets. Render::Simple doesn't do it, though it
       would be possible to make your own custom renderer.

AUTHOR

       FormHandler Contributors - see HTML::FormHandler

COPYRIGHT AND LICENSE

       This software is copyright (c) 2017 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.26.1                                       2017-11-11                     HTML::FormHandler::Blocks(3pm)