.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Form::Control::selectdyn 3pm"
.TH Form::Control::selectdyn 3pm "2020-11-09" "perl v5.32.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Embperl::Form::Control::selectdyn \- A dynamic select control inside an Embperl Form
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 8
\&  {
\&  type    => \*(Aqselectdyn\*(Aq,
\&  text    => \*(Aqblabla\*(Aq,
\&  name    => \*(Aqfoo\*(Aq,
\&  values  => [1,2,3],
\&  options => [\*(Aqfoo\*(Aq, \*(Aqbar\*(Aq, \*(Aqnone\*(Aq],
\&  rows    => 5
\&  }
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Used to create an select control inside an Embperl Form.
See Embperl::Form on how to specify parameters.
.SS "\s-1PARAMETER\s0"
.IX Subsection "PARAMETER"
\fItype\fR
.IX Subsection "type"
.PP
Needs to be 'select'
.PP
\fIname\fR
.IX Subsection "name"
.PP
Specifies the name of the select control
.PP
\fItext\fR
.IX Subsection "text"
.PP
Will be used as label for the select control
.PP
\fIvalues\fR
.IX Subsection "values"
.PP
Gives the values as an array ref of the select control.
.PP
\fIoptions\fR
.IX Subsection "options"
.PP
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.
.PP
\fIrows\fR
.IX Subsection "rows"
.PP
If specified a select box is display with the given number of lines.
If not specified or undef, a drop down list is shown.
.PP
\fIaddtop\fR
.IX Subsection "addtop"
.PP
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:
.PP
.Vb 1
\&    addtop => [ [1 => \*(Aqfirst item\*(Aq], [2 => \*(Aqsecond item\*(Aq]]
.Ve
.PP
\fIaddbottom\fR
.IX Subsection "addbottom"
.PP
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:
.PP
.Vb 1
\&    addbottom => [ [9999 => \*(Aqlast item\*(Aq], [9999 => \*(Aqvery last item\*(Aq]]
.Ve
.PP
\fIfilter\fR
.IX Subsection "filter"
.PP
If given, only items where the value matches the regex given in
\&\f(CW\*(C`filter\*(C'\fR are displayed.
.PP
\fIshowurl\fR
.IX Subsection "showurl"
.PP
This \s-1URL\s0 will be requested if the user clicks on \s-1SHOW\s0 in the popup or
double clicks the control. The value of the selected option will be
appended to that url. Should be something like '/foo/bar.epl?id='.
\&\s-1NOTE:\s0 This \s-1URL\s0 is not encoded in anyway, so make sure it is properly
url encoded.
.PP
\fIdatasrcurl\fR
.IX Subsection "datasrcurl"
.PP
This \s-1URL\s0 will be requested when the user types any input to request
the data for the control. The characters the users has typed will be
passed by the parameter query and the name of the datasrc attribute
will be passed in the datasrc parameter.
\&\s-1NOTE:\s0 This \s-1URL\s0 is not encoded in anyway, so make sure it is properly
url encoded.
.PP
\fIshow_on_select\fR
.IX Subsection "show_on_select"
.PP
If true show the selected item as soon as it is selected (useses showurl)
.PP
\fIuse_ajax\fR
.IX Subsection "use_ajax"
.PP
If set to an id of an html element, documents that are loaded via showurl
are fetch via ajax into this html container, instead of fetching a whole page.
.PP
\fI\f(CI$fdat\fI{\-init\-<name>}\fR
.IX Subsection "$fdat{-init-<name>}"
.PP
If set this value is used to prefill the input box, if not set get_values
method of the datasource object is call, which might be take a long time
in case of many options.
.SH "Author"
.IX Header "Author"
G. Richter (richter at embperl dot org)
.SH "See Also"
.IX Header "See Also"
\&\fBperl\fR\|(1), Embperl, Embperl::Form