---
name: "Embperl::Form::Control::button"
section: "3pm"
platform: "linux"
package: "libembperl-perl"
version: "2.5.0-17"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/Embperl::Form::Control::button"
---

# Embperl::Form::Control::button(3pm)

A button inside an Embperl Form

## NAME

Embperl::Form::Control::submit - A button inside an Embperl Form

## SYNOPSIS

```
  {
  type => 'submit',
  text => 'send',
  name => 'foo',
  value => 'xxx',
  image => 'xxx',
  onclick => 'window.open (...)',
  button => [
             {
             onclick     => 'do_something()',
             style       => 'border: 1px solid black;',
             },
             {
             name        => 'foobar',
             value       => 'Click here, too',
             onclick     => 'do_something()',
             class       => 'HurzCSSClass',
             onmouseover => 'do(this)';
             onmouseout  => 'do(that)';
             }
            ]
  }
```

## 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.

### PARAMETER

*type*

Needs to be 'button'

*name*

Name of the button

*text*

Will be used as label for the submit button or tool tip in case of an image button

*value*

Gives the value to send

*image*

URL of an image. If given an image button will be created, if absent, an normal submit button will be created.

*onclick*

Javascript that should be executed when the users clicks on the button.

*button*

hashref of the key-value pairs of all attribute the button needs.

## Author

G. Richter (richter at embperl dot org), A. Beckert (beckert@ecos.de)

## See Also

[**perl**(1)](/perl/1.md), Embperl, Embperl::Form