print $query->popup_menu('menu_name',
['eenie','meenie','minie'],
'meenie');
-or-
%labels = ('eenie'=>'your first choice',
'meenie'=>'your second choice',
'minie'=>'your third choice');
print $query->popup_menu('menu_name',
['eenie','meenie','minie'],
'meenie',\%labels);
-or (named parameter style)-
print $query->popup_menu(-name=>'menu_name',
-values=>['eenie','meenie','minie'],
-default=>'meenie',
-labels=>\%labels);
popup_menu
creates a menu.
-
The required first argument is the menu's name (-name).
-
The required second argument (-values) is an array reference
containing the list of menu items in the menu. You can pass the method an
anonymous array, as shown in the example, or a reference to a named array,
such as ``\@foo''.
-
The optional third parameter (-default) is the name of the default menu
choice. If not specified, the first item will be the default. The values of
the previous choice will be maintained across queries.
-
The optional fourth parameter (-labels) is provided for people who want to
use different values for the user-visible label inside the popup menu nd
the value returned to your script. It's a pointer to an associative array
relating menu values to user-visible labels. If you leave this parameter
blank, the menu values will be displayed by default. (You can also leave a
label undefined if you want to).
When the form is processed, the selected value of the popup menu can be
retrieved using:
$popup_menu_value = $query->param('menu_name');
JAVASCRIPTING: popup_menu
recognizes the
following event handlers:
-onChange, -onFocus, and -onBlur. See the textfield
section for details on when these handlers
are called.