start page | rating of books | rating of authors | reviews | copyrights

Perl in a Nutshell

Perl in a NutshellSearch this book
Previous: Reference: checkbox Chapter 10
The CGI.pm Module
Next: Reference: cookie
 

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.


Previous: Reference: checkbox Perl in a Nutshell Next: Reference: cookie
Reference: checkbox Book Index Reference: cookie