checkbox_group
print $query->checkbox_group('name', \@list [, selected,'true',\%labelhash ])
- Generates a list of checkbox elements.
- name
- The name to assign the input to (required).
- \@list
- An array reference with the list items. You can also use an anonymous array reference.
- selected
- The menu item(s) to be initially selected (default is that nothing is selected). This can be a single value or a reference to an array of values.
- 'true'
- Insert newlines between the checkboxes.
- \%labelhash
- A hash reference listing labels for each list item. Default is the list text itself. See
popup_menu
for an example.Using named parameters, the syntax is:
print $query->checkbox_group(-name=>'name', -values=>\@list, -default=>selected, -linebreak=>'true', -labels=>\%labelhash, -columns=>n, -columnheader=>'string', -rows=>m, -rowheader=>'string', -onClick=>function);
-columns=>
n
- The number of columns to use.
-columnheader=>
'string'
- A header for the column.
-rows=
m
- The number of rows to use. If omitted and
-columns
is specified, the rows will be calculated for you. -rowheader=>
'string'
- A header for the row.
-onClick=>
function
- Browser should execute
function
when the user clicks on any checkbox in the group.