NAME
HTML::DOM::NodeList::Radio - A Perl class for representing lists of radio buttons in an HTML DOM tree
SYNOPSIS
use HTML::DOM;
$doc = HTML::DOM->new;
$doc->write('
<form>
<input name=r type=radio value=one>
<input name=r type=radio value=two>
</form>
');
$doc->close;
$radio_list = $doc->forms->[0]->find_input('r');
# returns an HTML::DOM::NodeList::Radio object
$radio_list->[0]; # get first button
$radio_list->item(0); # same
# also:
$radio_list->value('two'); # select a radio button
$radio-list->name; # returns 'r'
DESCRIPTION
An object of this class represents a list of radio buttons in an HTML::DOM tree. This class inherits from HTML::DOM::NodeList:: and is provided solely for compatibility with WWW::Mechanize.
METHODS
In addition to those inherited from HTML::DOM::NodeList, this class implements the following methods:
- type
-
Returns the string 'radio'.
- name
-
Returns the name of the set of radio buttons. If you pass an argument, it will become the new name of the set (all the buttons will be renamed), and the old name will be returned.
- value
-
Returns the value attribute of the currently selected radio button. If you pass a value as an argument, the radio button with that value will be selected, and the value of the previously selected one will be returned.
- possible_values
-
Returns a list of the value attributes of all the radio buttons.
- form_name_value
-
Returns a list of two items: (0) the name of the set of buttons and (1) the value of the currently selected button.
SEE ALSO
HTML::DOM::Collection::Elements
The source of HTML/DOM/Element/Form.pm, where this is implemented.