NAME

Apache::Wyrd::Input::Set - Form Input Wyrds (array)

SYNOPSIS

    <BASENAME::Input::Set name="numbers"
      type="pulldown" options="one, two, three" />

    <BASENAME::Input::Set name="numbers" type="selections"
      hash_options="one, One, two, Two, three, Three" />

    <BASENAME::Input::Set name="numbers" type="checkboxes">
      <BASENAME::Input::Opt name="one" value="One" />
      <BASENAME::Input::Opt name="two" value="Two" />
      <BASENAME::Input::Opt name="three" value="Three" />
    </BASENAME::Input::Set>

    <BASENAME::Input::Set name="numbers" type="radiobuttons">
      <BASENAME::Input::Opt name="one">One</BASENAME::Input::Opt>
      <BASENAME::Input::Opt name="two">Two</BASENAME::Input::Opt>
      <BASENAME::Input::Opt name="three">Three</BASENAME::Input::Opt>
    </BASENAME::Input::Set>

DESCRIPTION

The Set Input extends the regular input to handle the parameters of multiple values. This module designs _startup_foo where foo is:

• A set of check-boxes

• A pull-down menu of items

• A set of radio-buttons

• A box of selections

For these, set the type attribute to checkboxes, pulldown, radiobuttons, and selections respectively. see Apache::Wyrd::Input::Set.

HTML ATTRIBUTES

As with Apache::Wyrd::Input, most attributes that can be set for the corresponding HTML tags these Wyrds generate can be set, such as class and onfocus.

emptyname

What to call the null option, or the empty value. Defaults to the null string.

options

When not using Apache::Wyrd::Input::Opt objects to populate the selection, a comma/whitespace-delimited set of options can be given instead.

hash_options

When not using Apache::Wyrd::Input::Opt objects to populate the selection, a comma-delimited hash of options can be given instead. The sequence is param value, param label, param value, param label....

delimiter

Override the default behavior for parsing options or hash_options by using the indicated regexp as delimiter. Defaults to commas if there are any or whitespace if not.

flags

noauto

Do not automatically format the opt area, but allow the options and the HTML around them to remain. This allows manual layout of checkboxes, etc. This implies "nosort".

nosort

Do not sort the options.

noempty

Do not generate the empty option "" on pulldown menus.

emptyname

Generate the empty option on pulldown menus, but give it this name, for example "None".

PERL METHODS

see Apache::Wyrd::Input

BUGS/CAVEATS/RESERVED METHODS

Reserves the _generate_output, final_output, and _process_child methods.

AUTHOR

Barry King <wyrd@nospam.wyrdwright.com>

SEE ALSO

Apache::Wyrd

General-purpose HTML-embeddable perl object

Apache::Wyrd::Input::Opt

Options of the multi-value Input.

LICENSE

Copyright 2002-2007 Wyrdwright, Inc. and licensed under the GNU GPL.

See LICENSE under the documentation for Apache::Wyrd.