NAME

HTML::Widget::Factory - churn out HTML widgets

VERSION

version 0.01

$Id: /my/icg/widget/trunk/lib/HTML/Widget/Factory.pm 16604 2005-11-22T03:41:18.244169Z rjbs  $

SYNOPSIS

my $widget = HTML::Widget::Factory->new();

my $html = $widget->select({
  name    => 'flavor',
  options => [
    [ minty => 'Peppermint',     ],
    [ perky => 'Fresh and Warm', ],
    [ super => 'Red and Blue',   ],
  ],
  value   => 'minty',
});

DESCRIPTION

HTML::Widget::Factory provides a simple, pluggable system for constructing HTML form controls.

METHODS

Most of the useful methods in an HTML::Widget::Factory object will be installed there by its plugins. Consult the documentation for the HTML::Widget::Plugin modules.

new

This constructor returns a new widget factory. It ignores all its arguments.

TODO

• fixed_args for args that are fixed, like (type => 'checkbox')

• a simple way to say "only include this output if you haven't before"

  This will make it easy to do JavaScript inclusions: if you've already made a calendar (or whatever) widget, don't bother including this hunk of JS, for example.

• giving the constructor a data store

  Create a factory that has a CGI.pm object and let it default values to the param that matches the passed name.

• include id attribute where needed

• optional labels (before or after control, or possibly return a list)

SEE ALSO

" HTML::Widget::Plugin "

" HTML::Widget::Plugin::Input "

" HTML::Widget::Plugin::Password "

" HTML::Widget::Plugin::Select "

" HTML::Widget::Plugin::Multiselect "

" HTML::Widget::Plugin::Checkbox "

" HTML::Widget::Plugin::Radio "

" HTML::Element "

AUTHOR

Ricardo SIGNES <rjbs @ cpan.org>

COPYRIGHT

Copyright (C) 2005, Ricardo SIGNES. This is free software, released under the same terms as perl itself.