NAME

HTML::DOM::Element::TextArea - A Perl class for representing 'textarea' elements in an HTML DOM tree

VERSION

Version 0.054

SYNOPSIS

  use HTML::DOM;
  $doc = HTML::DOM->new;
  $elem = $doc->createElement('textarea');
  $elem->focus();
  $elem->blur();
  # etc.
  $elem->value('some text') # set attribute
  $elem->rows;              # get attribute
  $elem->tagName;
  # etc.

DESCRIPTION

This class implements 'textarea' elements in an HTML::DOM tree. It implements the HTMLTextAreaElement DOM interface and inherits from HTML::DOM::Element (q.v.).

METHODS

In addition to those inherited from HTML::DOM::Element and its superclasses, this class implements the following DOM methods:

accessKey

cols

disabled

name

readOnly

rows

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.

defaultValue

Returns the text content of the element. This currently does not work if the 'textarea' element has more than one child.

form

Returns the form containing this input element.

type

Returns the string 'textarea'.

value

This method allows one to change the current value of the input field. The change is not reflected in the HTML tree. This will be called with the value of "defaultValue" when the form's "reset" method is invoked.

blur

focus

select

Each of these triggers the corresponding event.

In addition, the following methods are provided for compatibility with WWW::Mechanize:

possible_values

This returns an empty list.

form_name_value

Returns a list of two items: (0) the name of the field and (1) the value.

SEE ALSO

HTML::DOM HTML::DOM::Element HTML::DOM::Element::Form