---
name: "Embperl::Form::Control::checkbox"
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::checkbox"
---

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

A checkbox control inside an Embperl Form

## NAME

Embperl::Form::Control::checkbox - A checkbox control inside an Embperl Form

## SYNOPSIS

```
  {
  type  => 'checkbox',
  text  => 'blabla',
  name  => 'foo',
  value => 'bar'
  }
```

## DESCRIPTION

Used to create an checkbox control inside an Embperl Form. See Embperl::Form on how to specify parameters.

### PARAMETER

*type*

Needs to be 'checkbox'

*name*

Specifies the name of the checkbox control

*force\_name*

overwrites the name of the control. This is especially useful inside grids, where you can force the name of all checkboxes  in all rows to be the same name.

*text*

Will be used as label for the checkbox control

*value*

Gives the value for the checkbox.

%%\<xx\>%% is replaced by `$fdat`{\<xx\>}

%%%name%%% is replaced by `$fdat`{\<name\>}, where \<name\> is the value that is given with name parameter. Is is especially useful inside of grids where the actual name of the html control is computed dynamically.

*class*

Extra css class

## Author

G. Richter (richter at embperl dot org)

## See Also

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