HTML::Formulate
===============

HTML::Formulate is a perl module used to produce HTML forms. It uses
a presentation definition hash to control the output format, which is
great for flexible programmatic control, inheritance, and subclassing
(e.g. defining site- or section-specific HTML::Formulate subclasses 
and then producing standardised forms very easily). On the other hand, 
it doesn't give you the very fine-grained control over presentation 
that you get using a template-based system.

Example:

   # Simple employee create form
   $f = HTML::Formulate->new({
      fields => [ qw(firstname surname email position) ],
      required => [ qw(firstname surname) ],
   });
   print $f->render;

prints:

   <form method="post">
   <table cellpadding="2">
   <tr><th style="color:blue"><span class="required">Firstname</span></th><td><input name="firstname" type="text" /></td></tr>
   <tr><th style="color:blue"><span class="required">Surname</span></th><td><input name="surname" type="text" /></td></tr>
   <tr><th>Email</th><td><input name="email" type="text" /></td></tr>
   <tr><th>Position</th><td><input name="position" type="text" /></td></tr>
   <tr><td align="center" colspan="2">
   <input name="_submit" type="submit" value="Submit" />
   </td></tr>
   </table>
   </form>



INSTALLATION

The standard:

   perl Makefile.PL
   make
   make test
   make install


DEPENDENCIES

This module requires the standard Carp module, and will use CGI::Carp if 
it's available.


COPYRIGHT AND LICENCE

Copyright (C) 2003-2004 Gavin Carr

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself. 

