Father Chrysostomos > HTML-DOM > HTML::DOM::Attr

Download:
HTML-DOM-0.054.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
Stalled  1
View/Report Bugs
Module Version: 0.054   Source  

NAME ^

HTML::DOM::Attr - A Perl class for representing attribute nodes in an HTML DOM tree

SYNOPSIS ^

  use HTML::DOM;
  $doc = HTML::DOM->new;
  $attr = $doc->createAttribute('href');
  $attr->nodeValue('http://localhost/');
  $elem = $doc->createElement('a');
  $elem->setAttributeNode($attr);
  
  $attr->nodeName;  # href
  $attr->nodeValue; # http://...
  
  $attr->firstChild; # a text node
  
  $attr->ownerElement; # returns $elem

DESCRIPTION ^

This class is used for attribute nodes in an HTML::DOM tree. It implements the Node and Attr DOM interfaces and inherits from HTML::DOM::EventTarget. An attribute node stringifies to its value. As a boolean it is true, even if its value is false.

METHODS ^

Attributes

The following DOM attributes are supported:

nodeName
name

These both return the name of the attribute.

nodeType

Returns the constant HTML::DOM::Node::ATTRIBUTE_NODE.

nodeValue
value

These both return the attribute's value, setting it if there is an argument.

specified

Returns true if the attribute was specified explicitly in the source code or was explicitly added to the tree.

parentNode
previousSibling
nextSibling
attributes
namespaceURI
prefix
localName

All of these simply return an empty list.

childNodes

In scalar context, this returns a node list object with one text node in it. In list context it returns a list containing just that text node.

firstChild
lastChild

These both return the attribute's text node.

ownerDocument

Returns the document to which the attribute node belongs.

ownerElement

Returns the element to which the attribute belongs.

Other Methods

insertBefore
removeChild
appendChild

These three just throw exceptions.

replaceChild

If the first argument is a text node and the second is the attribute node's own text node, then the latter is replaced with the former. This throws an exception otherwise.

hasChildNodes

Returns true.

cloneNode

Returns a clone of the attribute.

normalize

Does nothing.

hasAttributes

Returns false.

isSupported

Does the same thing as HTML::DOM::Implementation's hasFeature method.

SEE ALSO ^

HTML::DOM

HTML::DOM::Node

HTML::DOM::Element

HTML::DOM::EventTarget

syntax highlighting: