.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" 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::button 3pm"
.TH Form::Control::button 3pm "2023-01-22" "perl v5.36.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::submit \- A button inside an Embperl Form
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 7
\&  { 
\&  type => \*(Aqsubmit\*(Aq,
\&  text => \*(Aqsend\*(Aq, 
\&  name => \*(Aqfoo\*(Aq,
\&  value => \*(Aqxxx\*(Aq,
\&  image => \*(Aqxxx\*(Aq,
\&  onclick => \*(Aqwindow.open (...)\*(Aq,
\&
\&  button => [
\&             {
\&             onclick     => \*(Aqdo_something()\*(Aq,
\&             style       => \*(Aqborder: 1px solid black;\*(Aq,
\&             },
\&             {
\&             name        => \*(Aqfoobar\*(Aq,
\&             value       => \*(AqClick here, too\*(Aq,
\&             onclick     => \*(Aqdo_something()\*(Aq,
\&             class       => \*(AqHurzCSSClass\*(Aq,
\&             onmouseover => \*(Aqdo(this)\*(Aq;
\&             onmouseout  => \*(Aqdo(that)\*(Aq;
\&             }
\&            ]
\&
\&  }
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
Used to create an submit control inside an Embperl Form.
If an image is given it will create an image button.
See Embperl::Form on how to specify parameters.
.SS "\s-1PARAMETER\s0"
.IX Subsection "PARAMETER"
\fItype\fR
.IX Subsection "type"
.PP
Needs to be 'button'
.PP
\fIname\fR
.IX Subsection "name"
.PP
Name of the button
.PP
\fItext\fR
.IX Subsection "text"
.PP
Will be used as label for the submit button or tool tip
in case of an image button
.PP
\fIvalue\fR
.IX Subsection "value"
.PP
Gives the value to send
.PP
\fIimage\fR
.IX Subsection "image"
.PP
\&\s-1URL\s0 of an image. If given an image button will be created,
if absent, an normal submit button will be created.
.PP
\fIonclick\fR
.IX Subsection "onclick"
.PP
Javascript that should be executed when the users clicks on the button.
.PP
\fIbutton\fR
.IX Subsection "button"
.PP
hashref of the key-value pairs of all attribute the button needs.
.SH "Author"
.IX Header "Author"
G. Richter (richter at embperl dot org), A. Beckert (beckert@ecos.de)
.SH "See Also"
.IX Header "See Also"
\&\fBperl\fR\|(1), Embperl, Embperl::Form