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

Changes for version 3.04

  • In addition to the below features, a new Catalyst FormBuilder plugin is available on CPAN, "Catalyst::Plugin::FormBuilder".
  • New $form->prepare() method You can now use "$form->prepare()" to get back an expanded hashref just before "$form->render()" is called. This allows you to use FormBuilder with Catalyst or other frameworks more easily, where the rendering is done elsewhere:
    • my %expansion = $form->prepare;
    • This could be passed directly to, say, Template Toolkit without having to use FormBuilder's Template Toolkit support.
  • New "inflate" option to field() This is used the convert fields on the fly into objects or other values. For example, you could convert a "date" field into a DateTime object. Nice patch from Mark Hedges, check it out.
  • Turkish messages Thanks to Recai Oktas.
  • Added "missing" property for fields This can be queried in templates. To see if a field is missing altogether, you can check "field.missing" or "missing-field" depending on your template engine of choice.
  • Removal of custom "puke" and "belch" FormBuilder now uses "Carp" and @CARP_NOT to handle its errors. As such, you will probably notice some differences in error output. The benefit is that setting "debug" will give you a stack trace on fatal errors.
  • CGI::FormBuilder::Template::Builtin Moved the "render_builtin()" method to the above module, to unify the rendering schemes.
  • New FORMBUILDER_DEBUG environment variable Setting this has the same effect as using the "debug" option.
  • Removal of excess documentation Removed all the stub docs from "Field::*" and "Messages::*" to make CPAN happy.

Documentation

Changes in FormBuilder 3.0, please also see the README
how to install FormBuilder 3.0
README for FormBuilder 3.0, please also see Changes

Modules

Easily generate and process stateful forms
Base class for FormBuilder fields
Localized message support for FormBuilder
Create multi-page FormBuilder forms
Source adapters for FormBuilder
Initialize FormBuilder from external file
Template adapters for FormBuilder
Builtin HTML rendering
FormBuilder interface to CGI::FastTemplate
FormBuilder interface to HTML::Template
FormBuilder interface to Template Toolkit
FormBuilder interface to Text::Template
Test harness for FormBuilder
Utility functions for FormBuilder

Provides

in lib/CGI/FormBuilder/Field/button.pm
in lib/CGI/FormBuilder/Field/checkbox.pm
in lib/CGI/FormBuilder/Field/file.pm
in lib/CGI/FormBuilder/Field/hidden.pm
in lib/CGI/FormBuilder/Field/image.pm
in lib/CGI/FormBuilder/Field/password.pm
in lib/CGI/FormBuilder/Field/radio.pm
in lib/CGI/FormBuilder/Field/select.pm
in lib/CGI/FormBuilder/Field/static.pm
in lib/CGI/FormBuilder/Field/text.pm
in lib/CGI/FormBuilder/Field/textarea.pm
in lib/CGI/FormBuilder/Messages/_example.pm
in lib/CGI/FormBuilder/Messages/C.pm
in lib/CGI/FormBuilder/Messages/da.pm
in lib/CGI/FormBuilder/Messages/da_DK.pm
in lib/CGI/FormBuilder/Messages/de.pm
in lib/CGI/FormBuilder/Messages/de_DE.pm
in lib/CGI/FormBuilder/Messages/default.pm
in lib/CGI/FormBuilder/Messages/en.pm
in lib/CGI/FormBuilder/Messages/en_US.pm
in lib/CGI/FormBuilder/Messages/es.pm
in lib/CGI/FormBuilder/Messages/es_ES.pm
in lib/CGI/FormBuilder/Messages/fr.pm
in lib/CGI/FormBuilder/Messages/fr_FR.pm
in lib/CGI/FormBuilder/Messages/ja.pm
in lib/CGI/FormBuilder/Messages/ja_JP.pm
in lib/CGI/FormBuilder/Messages/no.pm
in lib/CGI/FormBuilder/Messages/no_NO.pm
in lib/CGI/FormBuilder/Messages/tr.pm
in lib/CGI/FormBuilder/Messages/tr_TR.pm