HTML::FormHandler::Blocks(3pm)				User Contributed Perl Documentation			    HTML::FormHandler::Blocks(3pm)

NAME

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

VERSION

       version 0.40013

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

perl v5.14.2							    2012-06-25					    HTML::FormHandler::Blocks(3pm)