The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

Changes for version 0.03000 - 2008-06-19

  • Field container_tag() now defaults to 'div' rather than 'span' to provide better layout without CSS.
  • Multi block no longer sets container_tag() to 'span' - defaults to 'div'.
  • HTML::FormFu::Model::DBIC moved out into a separate distribution.
  • Models now accessed through new form method: model(), with accompanying methods: default_model() and model_config.
  • Deprecated form methods: model_class(), defaults_from_model(), save_to_model().
  • Model methods renamed to: default_model(), default_values() and update().
  • New model method: create().
  • Deprecated element method: db().
  • Bugfixes for perl 5.10.0 (missing imports).
  • Bugfix: insert_before() and insert_after() now check if the object is already a child, and if so, removes it first. Reported by Ferruccio Zamuner.
  • Bugfix: update() many_to_many multi-value fields where 'default_column' included the table name (or 'me.') failed.
  • Bugfix: make inflators work with multiple submitted values.
  • Bugfix for Bool constraint: use '?' quantifier, not '*'.
  • Bugfix in Email constraint: ensure Email::Valid->address() is called in scalar context.
  • New Split and CompoundJoin filters.
  • New CompoundDateTime inflator.
  • New CompoundSplit and CompoundDateTime deflators.
  • New Plugin system (see tests, not yet documented) and StashValid plugin.
  • New MultiForm system for multi-page forms (see tests, not yet documented).
  • New form methods: stash_valid(), params_ignore_underscore() and tmp_upload_dir().
  • New method for _Group fields: empty_first_label().
  • Multi->render_data() now builds itself before it's children, so that deflators on the Multi work.
  • insert_before() and insert_after() now first removes the object if it's already a child of the target.
  • Callback filter and transformers now receive $params as a 2nd argument.
  • _Group field options() now supports value_xml, value_loc, label_xml and label_loc args.
  • get_* methods (fields, elements, constraints, etc) now accept any valid method-name as a search parameter.
  • add default_natural() method to Date element, allowing the use of DateTime::Format::Natural to parse dates such as "today" or "yesterday".
  • when() method for Constraints can now accept a callback
  • Transformer callbacks now get $params as second argument (as Constraints aready were getting)
  • Form method add_valid() now expects a full nested-name.
  • auto_id() now translates "%n" into the full nested-name.
  • Add a END block to DBICTestLib that cleans up the t/test.db

Documentation

Cooking with HTML::FormFu
Working with unicode

Modules

HTML Form Creation, Rendering and Validation Framework
Constrain User Input
ASCII Characters Constraint
Multi-field All or None Constraint
Set Constraint for Selects / Radiogroups
Boolean Constraint
Code Callback Constraint
Code Callback Constraint
Multi-field Dependency Constraint
Email Address Constraint
Multi-field Equality Constraint
File Upload Constraint
Unsigned Integer Constraint
Min/Max Length String Constraint
Maximum Length String Constraint
Minimum Length String Constraint
Min/Max Multi-field Constraint
Numerical Constraint
Printable Characters Constraint
Numerical Range Constraint
Required Field Constraint
Set of Values Constraint
Single Value Constraint
Single Word Constraint
Base class for constraints needing others() method
Deflator Base Class
CompoundDateTime deflator
CompoundSplit deflator
Element Base Class
Button form field
Checkbox form field
Group of checkbox form fields
Button form field containing markup
3 select menu multi-field
File upload form field
Hidden form field
Image button form field
Combine multiple fields in a single element
Password form field
Radio form field
Group of radiobutton form fields
repeatable block element
Reset button form field
Select form field
Submit button form field
Text form field
Textarea form field
grouped form field base-class
input field base-class
Filter Base Class
filter with custom subroutine
copy the value from an other field
Encode/Decode Submitted Values
Inflator Base Class
CompoundDateTime inflator
base class for models
Post-process HTML output
Nicely Indent HTML Output
Strip shitespace from HTML output
base class for plugins
place valid params on form stash
base class for constraints
Transformer Base Class
Validator Base Class

Provides

in lib/HTML/FormFu/Deploy.pm
in lib/HTML/FormFu/Exception.pm
in lib/HTML/FormFu/Exception/Constraint.pm
in lib/HTML/FormFu/Exception/Inflator.pm
in lib/HTML/FormFu/Exception/Input.pm
in lib/HTML/FormFu/Exception/Transformer.pm
in lib/HTML/FormFu/Exception/Validator.pm
in lib/HTML/FormFu/FakeQuery.pm
in lib/HTML/FormFu/I18N.pm
in lib/HTML/FormFu/I18N/de.pm
in lib/HTML/FormFu/I18N/en.pm
in lib/HTML/FormFu/I18N/es.pm
in lib/HTML/FormFu/I18N/ja.pm
in lib/HTML/FormFu/I18N/pt_pt.pm
in lib/HTML/FormFu/Literal.pm
in lib/HTML/FormFu/Localize.pm
in lib/HTML/FormFu/ObjectUtil.pm
in lib/HTML/FormFu/OutputProcessor/StripWhitespace.pm
in lib/HTML/FormFu/Preload.pm
in lib/HTML/FormFu/Util.pm
in lib/HTML/FormFu/base.pm

Examples