NAME
Embperl::Form::Control::select - A select control inside an Embperl Form
SYNOPSIS
{
type => 'select',
text => 'blabla',
name => 'foo',
values => [1,2,3],
options => ['foo', 'bar', 'none'],
rows => 5
}DESCRIPTION
Used to create an select control inside an Embperl Form. See Embperl::Form on how to specify parameters.
PARAMETER
type
Needs to be 'select'
name
Specifies the name of the select control
text
Will be used as label for the select control
values
Gives the values as an array ref of the select control.
options
Gives the options as an array ref that should be displayed to the user. If no options are given, the values from values are used.
rows
If specified a select box is display with the given number of lines. If not specified or undef, a drop down list is shown.
addtop
Array ref which contains items that should be added at the top of the select box. Each item consists of an array ref with two entries, the first is the value and the second is the option that is displayed on the page. If the second is missing the value (first entry)is displayed. Example:
addtop => [ [1 => 'first item'], [2 => 'second item']]addbottom
Array ref which contains items that should be added at the bottom of the select box. Each item consists of an array ref with two entries, the first is the value and the second is the option that is displayed on the page. If the second is missing the value (first entry)is displayed. Example:
addbottom => [ [9999 => 'last item'], [9999 => 'very last item']]filter
If given, only items where the value matches the regex given in filter are displayed.
multiple
If set to true, allows multiple selections.
Author
G. Richter (richter at embperl dot org)
See Also
perl(1), Embperl, Embperl::Form