GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  HTML::DOM::ELEMENT::SELECT (3)

.ds Aq ’

NAME

HTML::DOM::Element::Select - A Perl class for representing ’select’ elements in an HTML DOM tree

CONTENTS

VERSION

Version 0.054

SYNOPSIS



  use HTML::DOM;
  $doc = HTML::DOM->new;
  $elem = $doc->createElement(select);

  $elem->focus();
  $elem->blur();
 
  # $elem->add(...)    # not yet
  # $elem->remove(...) # implemented

  $elem->options; # a list of option elements

  $elem->name(foo) # set attribute
  $elem->type;       # get attribute
  $elem->tagName;
  # etc.

  $elem->[0]; # first option
  $elem->[1] = $doc->createElement(option);
  $elem->[0] = undef; # deletes it
  delete $elem->[0]; # same



DESCRIPTION

This class implements ’select’ elements in an HTML::DOM tree. It implements the HTMLSelectElement DOM interface and inherits from HTML::DOM::Element (q.v.).

ARRAY INTERFACE

You can use a ’select’ element as an array reference, to access the individual elements of its options array. @$elem actually does exactly the same thing as @{$elem->options}. See HTML::DOM::Collection::Options for more info on using the array.

METHODS

In addition to those inherited from HTML::DOM::Element and its superclasses, this class implements the following DOM methods:
type
disabled
multiple
name
size
tabIndex Each of these returns the corresponding HTML attribute. If you pass an argument, it will become the new value of the attribute, and the old value will be returned.
selectedIndex Returns the index of the selected option. If there is an argument, it selects the specified option and returns the index of the previous selection.
length Returns the number of options.
form Returns the form containing this input element.
options Returns a list of ’option’ elements in list context, or an HTML::DOM::Collection::Options object in scalar context.
value Selects the option with the value given if there is an argument and returns the old value, or simply returns the value if there is no argument.
blur
focus These each trigger the corresponding event.
In addition, the following methods are provided for compatibility with WWW::Mechanize:
possible_values This returns an empty list for most input elements, but for checkboxes it returns (undef, $value).
readonly An alias to readOnly.
form_name_value Returns a list of two items: (0) the name of the field and (1) the value.
check Same as $elem->checked(1).

SEE ALSO

HTML::DOM

HTML::DOM::Collection::Options

HTML::DOM::Element

HTML::DOM::Element::Form

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 HTML::DOM::ELEMENT::SELECT (3) 2014-12-23

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.