table of contents
HTML::FormHandler::Render::Simple(3pm) | User Contributed Perl Documentation | HTML::FormHandler::Render::Simple(3pm) |
NAME¶
HTML::FormHandler::Render::Simple - simple rendering roleVERSION¶
version 0.40067SYNOPSIS¶
This is a Moose role that is an example of a simple rendering routine for HTML::FormHandler. It's here as an example of how to write a custom renderer in one package, if you prefer that to using the widgets. It won't always be updated with improvements by default, because it was becoming a lot of work to update the rendering in multiple places.For a 'MyApp::Form::Renderer' which you've created and modified, in your Form class:
package MyApp::Form::Silly; use Moose; extends 'HTML::FormHandler::Model::DBIC'; with 'MyApp::Form::Renderers';
In a template:
[% form.render %]
The widgets are rendered with "$field->render"; rendering routines from a class like this use "$form->render_field('field_name')" to render individual fields:
[% form.render_field( 'title' ) %]
DESCRIPTION¶
This role provides HTML output routines for the 'widget' types defined in the provided FormHandler fields. Each 'widget' name has a 'widget_$name' method here.These widget routines output strings with HTML suitable for displaying form fields.
The widget for a particular field can be defined in the form. You can create additional widget routines in your form for custom widgets.
The fill-in-form values ('fif') are cleaned with the 'render_filter' method of the base field class. You can change the filter to suit your own needs: see HTML::FormHandler::Manual::Rendering
render¶
To render all the fields in a form in sorted order (using 'sorted_fields' method).render_start, render_end¶
These use the methods in HTML::FormHandler::Widget::Form::Simple now. If you want to customize them, copy them to your own package.Will render the beginning and ending <form> tags and fieldsets. Allows for easy splitting up of the form if you want to hand-render some of the fields.
[% form.render_start %] [% form.render_field('title') %] <insert specially rendered field> [% form.render_field('some_field') %] [% form.render_end %]
render_field¶
Render a field passing in a field object or a field name$form->render_field( $field ) $form->render_field( 'title' )
render_text¶
Output an HTML string for a text widgetrender_password¶
Output an HTML string for a password widgetrender_hidden¶
Output an HTML string for a hidden input widgetrender_select¶
Output an HTML string for a 'select' widget, single or multiplerender_checkbox¶
Output an HTML string for a 'checkbox' widgetrender_radio_group¶
Output an HTML string for a 'radio_group' selection widget. This widget should be for a field that inherits from 'Select', since it requires the existence of an 'options' array.render_textarea¶
Output an HTML string for a textarea widgetrender_compound¶
Renders field with 'compound' widgetrender_submit¶
Renders field with 'submit' widgetAUTHOR¶
FormHandler Contributors - see HTML::FormHandlerCOPYRIGHT AND LICENSE¶
This software is copyright (c) 2016 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.
2016-10-21 | perl v5.24.1 |