print $query->button(-name=>'name',
                     -value=>'label',
                     -onClick=>"function");

-value=>'label'

The label to display for the button

print $query->checkbox(-name=>'name',
                       -checked=>'checked',
                       -value=>'value',
                       -label=>'label',
                       -onClick=>function);

-onClick=>function

Browser should execute function when the user clicks on any checkbox in the group

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.

$cookie = $query->cookie(-name=>'name',
                         -value=>'value',
                         -expires=>'expcode',
                         -path=>'partial_url',
                         -domain=>'domain_name',
                         -secure=>1);
print $query->header(-cookie=>$cookie);

-value=>'value'

A value to assign to the cookie. You can supply a scalar value, or a reference to an array or hash. If omitted, a cookie will be retrieved rather than defined.

-expires=>expcode

Specifies an expiration timestamp (such as +3d for three days). Values for expcode are:

ns

n seconds

nm

n minutes

nh

n hours

nd

n days

nM

n months

ny

n years

day_of_week, dd-MMM-YY hh:mm:ss GMT

At the specified time.

now

Expires immediately.

-path=>'partial_url'

The partial URL for which the cookie is valid. Default is the current URL.

-domain=>'domain_name'

The domain for which the cookie is valid.

-secure=>1

Use this cookie only for a secure session.

print $query->header(-type=>'content_type',
                     -nph=>1,
                     -status=>'status_code',
                     -expires=>'expcode',
                     -cookie=>'cookie',
                     -target=>'frame',
                     -header=>'value');

-type=>content_type

Specifies the content type.

-nph=>1

Uses headers for a no-parse-header script.

-status=>status_code

Specifies the status code.

-expires=>expcode

Specifies an expiration timestamp (such as +3d for three days). Values for expcode are:

ns

n seconds

nm

n minutes

nh

n hours

nd

n days

nM

n months

ny

n years

day_of_week, dd-MMM-YY hh:mm:ss GMT

At the specified time

now

Expires immediately

-cookie=>cookie

Specifies a cookie. The cookie may be a scalar value or an array reference.

-header=>value

Specifies any HTTP header.

-target=>frame

Writes to specified frame.

print $query->hidden(-name=>'name',
                       -default=>'value');

With named parameters, the value can also be represented as a reference to an array, such as:

print $query->hidden(-name=>'name',
                     -default=>['value1', 'value2', 
...  ]);

print $query->image_button(-name=>'name',
                           -src=>'url',
                           -align=>'align',
                           -onClick=>function);

-onClick=>function

Browser should execute function when the user clicks on the image

print $query->isindex(-action=>$action);

$query->param(-name=>'parameter',
              -value=>'newvalue');

or:

$query->param(-name=>'parameter',
              -values=>'newvalue1', 'newvalue2', ...);

print $query->password_field(-name=>'name',
                             -default=>'value',
                             -size=>size,
                             -maxlength=>maxlength,
                             -override=>1,
                             -onChange=>function,
                             -onFocus=>function,
                             -onBlur=>function,
                             -onSelect=>function);

-override=>1

Text field should not inherit its value from a previous invocation of the script

-onChange=>function

Browser should execute function when the user changes the text field

-onFocus=>function

Browser should execute function when the focus is on the text field

-onBlur=>function

Browser should execute function when the focus leaves the text field

-onSelect=>function

Browser should execute function when the user changes a selected portion of the text field

%labels = ('UPS'=>'United Parcel Service (UPS)',
         'FedExO'=>'Federal Express Overnight - 10AM delivery',
         'FedExS'=>'Federal Express Standard - 2PM delivery',
         'FedEx2'=>'Federal Express 2nd Day Delivery');

print $query->popup_menu('delivery_method', 
                       ['UPS', 'FedExO', 'FedExS', 'FedEx2'], 
                       'FedExO', 
                       \%labels);

Using named parameters, the syntax is:

print $query->popup_menu(-name=>'name',
                         -values=>\@array,
                         -default=>'selected',
                         -labels=>\%labelhash,
                         -onChange=>function,
                         -onFocus=>function,
                         -onBlur=>function);

-onChange=>function

Browser should execute function when the user changes the text field

-onFocus=>function

Browser should execute function when the focus is on on the text field

-onBlur=>function

Browser should execute function when the focus leaves the text field

print $query->radio_group(-name=>'name',
                          -values=>\@list,
                          -default=>'selected',
                          -linebreak=>'true',
                          -labels=>\%labelhash,
                          -columns=>n,
                          -columnheader=>'string',
                          -rows=>m,
                          -rowheader=>'string');

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

print $query->redirect(-uri=>'url',
                       -nph=>1);

print $query->scrolling_list(-name=>'name',
                             -values=>\@listarray,
                             -default=>selected,
                             -size=>size,
                             -multiple=>'true',
                             -labels=>\%labelhash,
                             -onChange=>function,
                             -onFocus=>function,
                             -onBlur=>function);

-onChange=>function

Browser should execute function when the user changes the text field

-onFocus=>function

Browser should execute function when the focus is on on the text field

-onBlur=>function

Browser should execute function when the focus leaves the text field

print $query->start_html(-title=>'title',
                         -author=>'email_address',
                         -base=>'true',
                         -xbase=>'url',
                         -meta=>{'metatag1'=>'value1',
                                 'metatag2'=>
                                            'value2'},
                         -script=>'$script',
                         -onLoad=>'$function',
                         -onUnload=>'$function',
                         -attribute=>'value');

-title=>'title'

Specifies the title of the page.

-author=>'email_address'

Specifies the author's email address.

-xbase=>'url'

Provides an HREF for the <BASE> tag. Default is the current location.

-meta=>{'metatag1'=>'value1', ... }

Adds arbitrary meta information to the header as a reference to a hash. Valid tags are:

keywords

Keywords for this document

copyright

Copyright for this document description

description

Description for this document

attribute=>'value'

Specifies an attribute to the <BODY> tag

POST

Use the POST method (default).

GET

Use the GET method.

print $query->startform(-method=>$method,
                        -action=>$action,
                        -encoding=>$encoding,
                        -name=>$name,
                        -target=>frame,
                        -onSubmit=>function);

-name=>name

Names the form for identification by JavaScript functions

-target=>frame

Writes to the specified frame

-onSubmit=>function

A JavaScript function that the browser should execute upon submitting the form

print $query->submit(-name=>'name',
                     -value=>'value',
                     -onClick=>function);

-onClick=>function

Browser should execute function when the user clicks on the image

print $query->textarea(-name=>'name',
                       -default=>'value',
                       -rows=>rows,
                       -columns=>columns,
                       -override=>1,
                       -onChange=>function,
                       -onFocus=>function,
                       -onBlur=>function,
                       -onSelect=>function);

-override=>1

Text field should not inherit its value from a previous invocation of the script

-onChange=>function

Browser should execute function when the user changes the text field

-onFocus=>function

Browser should execute function when the focus is on the text field

-onBlur=>function

Browser should execute function when the focus leaves the text field

-onSelect=>function

Browser should execute function when the user changes a selected portion of the text field

print $query->textfield(-name=>'name',
                        -default=>'value',
                        -size=>size,
                        -maxlength=>maxlength,
                        -override=>1,
                        -onChange=>function,
                        -onFocus=>function,
                        -onBlur=>function,
                        -onSelect=>function);

-override=>1

Text field should not inherit its value from a previous invocation of the script

-onChange=>function

Browser should execute function when the user changes the text field

-onFocus=>function

Browser should execute function when the focus is on the text field

-onBlur=>function

Browser should execute function when the focus leaves the text field

-onSelect=>function

Browser should execute function when the user changes a selected portion of the text field