HTML-FormHandler

Changes for version 0.40000

There are many changes to rendering, many of them incompatible. These changes *will* break existing form rendering. You must check that your rendering works before upgrading. Making a copy of the old code (the widget and rendering roles) may be helpful (or use the compatibility libraries -- see below). I always prefer to maintain backward compatibility if possible, but a number of the improvements were not possible without breaking compatibility, so I did a lot of changes at once. Compatibility libraries are provided to help support rendering that relied on the earlier libriaries at: git://github.com/gshank/html-formhandler_pre-0.40_compat.git README at: https://github.com/gshank/html-formhandler_pre-0.40_compat/blob/master/README
Add 'no_update' flag to allow skipping model_update. Remove 'deflate_to' flag; provide new inflation/deflation methods. see HTML::FormHandler::Manual::InflationDeflation New 'build_id_method' to provide different builder method for field IDs. 'auto_fieldset' and 'no_auto_fieldset' no longer used. No automatic fieldsets. Can be added with do_wrapper => 1 and a tag of wrapper_tag => 'fieldset' Localize the value of the reset button. Tests and fix for form 'validate_<field_name>' and 'default_<field_name>' method for repeatables fields. Change default radiogroup rendering to not use <br /> elements. Add back with tag radio_br_after => 1 Switch to using coderef for deflate_method; custom fields with deflate sub will need to be modified. Add block rendering (HTML::FormHandler::Blocks) Re-do code for default & validate method construction; now provides 'default_method' and 'validate_method' coderef setting Remove 'init_value_*' from Field (deprecated for years). Use Hash::Merge in merging update field info on creation Fix bug in copying tags to fields by cloning field definitions Switch to using name 'element_attr' in fields instead of 'html_attr' Put wrapper class 'hfh-repinst' on Repeatable Instances unless they already have a wrapper class Remove 'javascript' field attribute. Put into *_attr hashref. Automatically put 'error' on element and wrapper. Switch to having the 'class' as a separate attribute from the _attr collection. Use 'element_class', 'wrapper_class' & 'label_class' arrayrefs Switch to having widget names by default be camel case; provide convenience methods for templates - uwidget, uwrapper, twidget, twrapper.
- this change will affect existing template systems, if they use the $field->widget method to get the widget name. See example templates. and conversion methods 'ucc_widget' and 'cc_widget' in HTML::FormHandler::Render::Util
Create t/share/templates/form/form_in_one.tt Switch default rendering of checkbox to have label wrap input. Checkboxes are complicated. See t/render/checkbox.t for various options. Add 'build_update_subfields' to 'update_fields' processing to allow moving more of rendering settings into a separate role Change form 'html_attr' to 'form_element_attr', and use builder Change interface of html_field_attributes to also return attr (instead of just in-place) Remove 'label_no_colon', make labels without colon the default. Add widget tag 'label_after'. Use "label_after => ': '" for old behavior Add widget tag 'label_tag'. Default 'label'. Widget_tags replaced with 'form_tags' in form and 'tags' in Field. takes builder 'build_form_tags' instead of default Repeatable elements get automatic 'div' wrapper Remove attribute 'auto_fieldset'; wrapping form is no longer a default; Add back with sub build_do_form_wrapper {1}, and form_tags => { wrapper_tag => 'fieldset' } Remove automatic wrapping of compounds. Enable wrapping with do_wrapper => 1 (there's also do_label => 1) Put form wrapper around form tag instead of inside wrapper_start and wrapper_end tags not used to skip wrapper; use do_wrapper => 0 The 'get_tag' method now returns '' instead of undef if tag doesn't exist.

Documentation

HTML::FormHandler::Manual

index of the manual

HTML::FormHandler::Manual::Catalyst

using HFH forms in Catalyst

HTML::FormHandler::Manual::Cookbook

FormHandler use recipes

HTML::FormHandler::Manual::Database

FormHandler use recipes

HTML::FormHandler::Manual::Defaults

form defaults documentation

HTML::FormHandler::Manual::Errors

FormHandler use recipes

HTML::FormHandler::Manual::Fields

brief documentation of available fields

HTML::FormHandler::Manual::InflationDeflation

inflation and deflation of field values

HTML::FormHandler::Manual::Intro

introduction to using FormHandler

HTML::FormHandler::Manual::Reference

concise reference

HTML::FormHandler::Manual::Rendering

how to render with FormHandler

HTML::FormHandler::Manual::Templates

using templates

HTML::FormHandler::Manual::Testing

testing forms

HTML::FormHandler::Manual::Tutorial

how to use FormHandler with Catalyst

HTML::FormHandler::Manual::Validation

validating fields

Modules

HTML::FormHandler

HTML forms using Moose

HTML::FormHandler::Base

stub

HTML::FormHandler::Blocks

used in Wizard

HTML::FormHandler::BuildFields

role to build field array

HTML::FormHandler::BuildPages

used in Wizard

HTML::FormHandler::Field

base class for fields

HTML::FormHandler::Field::BoolSelect

Boolean select field

HTML::FormHandler::Field::Boolean

a true or false field

HTML::FormHandler::Field::Button

button field

HTML::FormHandler::Field::Captcha

captcha field with GD::SecurityImage

HTML::FormHandler::Field::Checkbox

a checkbox field type

HTML::FormHandler::Field::Compound

field consisting of subfields

HTML::FormHandler::Field::Date

a date field with formats

HTML::FormHandler::Field::DateMDY

m/d/y date field

HTML::FormHandler::Field::DateTime

compound DateTime field

HTML::FormHandler::Field::Display

display only field

HTML::FormHandler::Field::Duration

DateTime::Duration from HTML form values

HTML::FormHandler::Field::Email

validates email using Email::Valid

HTML::FormHandler::Field::File

simple file field; does no processing

HTML::FormHandler::Field::Float

validate a float value

HTML::FormHandler::Field::Hidden

hidden field

HTML::FormHandler::Field::Hour

accept integer from 0 to 23

HTML::FormHandler::Field::HtmlArea

input HTML in a textarea

HTML::FormHandler::Field::IntRange

integer range in select list

HTML::FormHandler::Field::Integer

validate an integer value

HTML::FormHandler::Field::Minute

input range from 0 to 59

HTML::FormHandler::Field::Money

US currency-like values

HTML::FormHandler::Field::Month

select list 1 to 12

HTML::FormHandler::Field::MonthDay

select list 1 to 31

HTML::FormHandler::Field::MonthName

select list with month names

HTML::FormHandler::Field::Multiple

multiple select list

HTML::FormHandler::Field::Nested

for nested elements of compound fields

HTML::FormHandler::Field::NoValue

base class for submit field

HTML::FormHandler::Field::Password

password field

HTML::FormHandler::Field::PasswordConf

password confirmation

HTML::FormHandler::Field::PosInteger

positive integer field

HTML::FormHandler::Field::PrimaryKey

primary key field

HTML::FormHandler::Field::Repeatable

repeatable (array) field

HTML::FormHandler::Field::Repeatable::Instance

used internally by repeatable fields

HTML::FormHandler::Field::Reset

reset field

HTML::FormHandler::Field::Result

result class for fields

HTML::FormHandler::Field::Second

select list 0 to 59

HTML::FormHandler::Field::Select

select fields

HTML::FormHandler::Field::Submit

submit field

HTML::FormHandler::Field::Text

text field

HTML::FormHandler::Field::TextArea

textarea input

HTML::FormHandler::Field::Upload

file upload field

HTML::FormHandler::Field::Weekday

select list day of week strings

HTML::FormHandler::Field::Year

year selection list

HTML::FormHandler::Fields

internal role for form and compound fields

HTML::FormHandler::Foo

Experiment in loading form from config file

HTML::FormHandler::I18N

internationalization

HTML::FormHandler::I18N::de_de

German message translations

HTML::FormHandler::I18N::en_us

base message file

HTML::FormHandler::I18N::hu_hu

Hungarian message file

HTML::FormHandler::I18N::ja_jp

Japanese message file

HTML::FormHandler::I18N::ru_ru

Russian message file

HTML::FormHandler::I18N::sv_se

Swedish message translations

HTML::FormHandler::I18N::tr_tr

Turkish message file

HTML::FormHandler::I18N::ua_ua

Ukrainian message file

HTML::FormHandler::InitResult

internal code

HTML::FormHandler::Merge

internal hash merging

HTML::FormHandler::Meta::Role

field_list and apply_list

HTML::FormHandler::Model

default model base class

HTML::FormHandler::Model::CDBI

Class::DBI model class (non-functioning)

HTML::FormHandler::Model::Object

stub for Object model

HTML::FormHandler::Moose

to add FormHandler sugar

HTML::FormHandler::Moose::Role

to add sugar to roles

HTML::FormHandler::Page

used in Wizard

HTML::FormHandler::Page::Simple

used by Wizard

HTML::FormHandler::Pages

used in Wizard

HTML::FormHandler::Params

params handling

HTML::FormHandler::Render::Simple

simple rendering role

HTML::FormHandler::Render::Table

render a form with a table layout

HTML::FormHandler::Render::Util

rendering utility

HTML::FormHandler::Render::WithTT

tt rendering

HTML::FormHandler::Result

form result object

HTML::FormHandler::Result::Role

role with common code for form & field results

HTML::FormHandler::Test

provides is_html method used in tests

HTML::FormHandler::TraitFor::Captcha

generate and validate captchas

HTML::FormHandler::TraitFor::I18N

localization

HTML::FormHandler::TraitFor::Types

types used internally in FormHandler

HTML::FormHandler::Traits

customized replacement for MooseX::Traits

HTML::FormHandler::Types

Moose type constraints

HTML::FormHandler::Validate

validation role (internal)

HTML::FormHandler::Widget::ApplyRole

role to apply widgets

HTML::FormHandler::Widget::Block

base block renderer

HTML::FormHandler::Widget::Block::Bootstrap

block to format bare form element like bootstrap

HTML::FormHandler::Widget::Field::Button

button field rendering widget

HTML::FormHandler::Widget::Field::ButtonTag

button field rendering widget, using 'button tag

HTML::FormHandler::Widget::Field::Captcha

Captcha field rendering widget

HTML::FormHandler::Widget::Field::Checkbox

HTML attributes field role

HTML::FormHandler::Widget::Field::CheckboxGroup

checkbox group field role

HTML::FormHandler::Widget::Field::Compound

compound field widget

HTML::FormHandler::Widget::Field::Hidden

hidden field rendering widget

HTML::FormHandler::Widget::Field::NoRender

no rendering widget

HTML::FormHandler::Widget::Field::Password

password rendering widget

HTML::FormHandler::Widget::Field::RadioGroup

radio group rendering widget

HTML::FormHandler::Widget::Field::Repeatable

repeatable field widget

HTML::FormHandler::Widget::Field::Reset

reset field rendering widget

HTML::FormHandler::Widget::Field::Role::HTMLAttributes

apply HTML attributes

HTML::FormHandler::Widget::Field::Role::SelectedOption

allow setting options from options keys

HTML::FormHandler::Widget::Field::Select

select field rendering widget

HTML::FormHandler::Widget::Field::Submit

submit field rendering widget

HTML::FormHandler::Widget::Field::Text

text field rendering widget

HTML::FormHandler::Widget::Field::Textarea

textarea rendering widget

HTML::FormHandler::Widget::Field::Upload

update field rendering widget

HTML::FormHandler::Widget::Form::Role::HTMLAttributes

set HTML attributes on the form tag

HTML::FormHandler::Widget::Form::Simple

widget to render a form with divs

HTML::FormHandler::Widget::Form::Table

render a form with a table layout

HTML::FormHandler::Widget::Theme::Bootstrap

sample bootstrap theme

HTML::FormHandler::Widget::Wrapper::Base

common methods for widget wrappers

HTML::FormHandler::Widget::Wrapper::Bootstrap

Twitter Bootstrap 2.0 field wrapper

HTML::FormHandler::Widget::Wrapper::Fieldset

fieldset field wrapper

HTML::FormHandler::Widget::Wrapper::None

wrapper that doesn't wrap

HTML::FormHandler::Widget::Wrapper::Simple

simple field wrapper

HTML::FormHandler::Widget::Wrapper::SimpleInline

simple field wrapper

HTML::FormHandler::Widget::Wrapper::Table

wrapper class for table layout

HTML::FormHandler::Widget::Wrapper::TableInline

wrapper class for table layout that doesn't wrap compound fields

HTML::FormHandler::Wizard

create a multi-page form

Other files

To install HTML::FormHandler, copy and paste the appropriate command in to your terminal.

cpanm

cpanm HTML::FormHandler

CPAN shell

perl -MCPAN -e shell
install HTML::FormHandler

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)

Changes for version 0.40000

Documentation

Modules

Other files

Module Install Instructions