NAME

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

VERSION

Version 0.058

SYNOPSIS

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

  $elem->setAttribute('href', 'http://www.perl.org/');
  $elem->getAttribute('href');
  $elem->tagName;
  # etc

DESCRIPTION

This class represents elements in an HTML::DOM tree. It is the base class for other element classes (see "CLASSES AND DOM INTERFACES" in HTML::DOM.) It implements the Element and HTMLElement DOM interfaces.

METHODS

Constructor

You should normally use HTML::DOM's createElement method. This is listed here only for completeness:

  $elem = new HTML::DOM::Element $tag_name;

$elem will automatically be blessed into the appropriate class for $tag_name.

Attributes

The following DOM attributes are supported:

tagName

Returns the tag name.

id

title

lang

dir

className

These five get (optionally set) the corresponding HTML attributes. Note that className corresponds to the class attribute.

style

This returns a CSS::DOM::Style object, representing the contents of the 'style' HTML attribute.

And there is also the following non-DOM attribute:

content_offset

This contains the offset (in characters) within the HTML source of the element's first child node, if it is a text node. This is set (indirectly) by HTML::DOM's write method. You can also set it yourself.

Other Methods

getAttribute ( $name )

Returns the attribute's value as a string.

setAttribute ( $name, $value )

Sets the attribute named $name to $value.

removeAttribute ( $name )

Deletes the $named attribute.

getAttributeNode ( $name )

Returns an attribute node (HTML::DOM::Attr).

setAttributeNode ( $attr )

Sets the attribute whose name is $attr->nodeName to the attribute object itself. If it replaces another attribute object, the latter is returned.

removeAttributeNode ( $attr )

Removes and returns the $attr.

getElementsByTagName ( $tagname)

This finds all elements with that tag name under the current element, returning them as a list in list context or a node list object in scalar context.

getElementsByClassName ( $names )

This finds all elements whose class attribute contains all the names in $names, which is a space-separated list; returning the elements as a list in list context or a node list object in scalar context.

hasAttribute ( $name )

Returns true or false, indicating whether this element has an attribute named $name, even one that is implied.

click() (HTML 5)

This triggers a click event on the element; nothing more.

trigger_event

This overrides HTML::DOM::Node's method to trigger a DOMActivate event after a click.

SEE ALSO

HTML::DOM

HTML::DOM::Node

HTML::Element

All the HTML::DOM::Element subclasses listed under "CLASSES AND DOM INTERFACES" in HTML::DOM