1HTML::FormHandler::FielUds:e:rChCeocnktbroixb(u3t)ed PerHlTMDLo:c:uFmoernmtHaatnidolner::Field::Checkbox(3)
2
3
4
6 HTML::FormHandler::Field::Checkbox - a checkbox field type
7
9 version 0.40068
10
12 This field is very similar to the Boolean Widget except that this field
13 allows other positive values besides 1. Since unselected checkboxes do
14 not return a parameter, fields with Checkbox type will always be set to
15 the 'input_without_param' default if they do not appear in the form.
16
17 widget
18 checkbox
19
20 checkbox_value
21 In order to create the HTML for a checkbox, there must be a
22 'value="xx"'. This value is specified with the 'checkbox_value'
23 attribute, which defaults to 1.
24
25 input_without_param
26 If the checkbox is not checked, it will be set to the value of this
27 attribute (the unchecked value). Default = 0. Because unchecked
28 checkboxes do not return anything in the HTTP parameters, the absence
29 of a checkbox key in the parameters hash forces this field to this
30 value. This means that Checkbox fields, unlike other fields, will not
31 be ignored if there is no input. If a particular checkbox should not be
32 processed for a particular form, you must set 'inactive' to 1 instead.
33
34 Note that a checkbox is only 'checked' when the 'checkbox_value' is
35 provided. The 'value' for a non-checked checkbox is only really useful
36 for creating form values such as are stored in a database.
37
39 FormHandler Contributors - see HTML::FormHandler
40
42 This software is copyright (c) 2017 by Gerda Shank.
43
44 This is free software; you can redistribute it and/or modify it under
45 the same terms as the Perl 5 programming language system itself.
46
47
48
49perl v5.36.0 2023-01-H2T0ML::FormHandler::Field::Checkbox(3)