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

NAME

HTML::Widget::Plugin::Input - the most basic input widget

VERSION

version 0.204

SYNOPSIS

  $widget_factory->input({
    id    => 'flavor',   # if "name" isn't given, id will be used for name
    size  => 25,
    value => $default_flavor,
  });

...or...

  $widget_factory->hidden({
    id    => 'flavor',   # if "name" isn't given, id will be used for name
    value => $default_flavor,
  });

DESCRIPTION

This plugin provides a basic input widget.

The default_classes attribute may be used to add a default class to every produced input. This class cannot be overridden.

  my $plugin = HTML::Widget::Factory::Input->new({
    default_classes => [ qw(foo bar) ],
  });

METHODS

provided_widgets

This plugin provides the following widgets: input, hidden

input

This method returns a basic one-line text-entry widget.

In addition to the generic HTML::Widget::Plugin attributes, the following are valid arguments:

value

This is the widget's initial value.

type

This is the type of input widget to be created. You may wish to use a different plugin, instead.

hidden

This method returns a hidden input that is not displayed in the rendered HTML. Its arguments are the same as those to input.

This method may later be factored out into a plugin.

build

  my $widget = $class->build($factory, $arg);

This method does the actual construction of the input based on the args collected by the widget-constructing method. It is primarily here for subclasses to exploit.

AUTHOR

Ricardo SIGNES

COPYRIGHT AND LICENSE

This software is copyright (c) 2005 by Ricardo SIGNES.

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