Reference: checkbox_group
Author: Ellen Siever, Stephen Spainhour & Nathan Patwardhan
Date: 1999-07-02T01:55:49Z

#

| Chapter 10 The CGI.pm Module |

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

Reference: checkbox |  | Reference: cookie