org.w3c.dom
Interface Element

All Superinterfaces:

Node

All Known Subinterfaces:

HTMLAnchorElement , HTMLAppletElement , HTMLAreaElement , HTMLBaseElement , HTMLBaseFontElement , HTMLBodyElement , HTMLBRElement , HTMLButtonElement , HTMLDirectoryElement , HTMLDivElement , HTMLDListElement , HTMLElement , HTMLFieldSetElement , HTMLFontElement , HTMLFormElement , HTMLFrameElement , HTMLFrameSetElement , HTMLHeadElement , HTMLHeadingElement , HTMLHRElement , HTMLHtmlElement , HTMLIFrameElement , HTMLImageElement , HTMLInputElement , HTMLIsIndexElement , HTMLLabelElement , HTMLLegendElement , HTMLLIElement , HTMLLinkElement , HTMLMapElement , HTMLMenuElement , HTMLMetaElement , HTMLModElement , HTMLObjectElement , HTMLOListElement , HTMLOptGroupElement , HTMLOptionElement , HTMLParagraphElement , HTMLParamElement , HTMLPreElement , HTMLQuoteElement , HTMLScriptElement , HTMLSelectElement , HTMLStyleElement , HTMLTableCaptionElement , HTMLTableCellElement , HTMLTableColElement , HTMLTableElement , HTMLTableRowElement , HTMLTableSectionElement , HTMLTextAreaElement , HTMLTitleElement , HTMLUListElement

All Known Implementing Classes:

IIOMetadataNode

public interface Element
extends Node   

The Element interface represents an element in an HTML or XML document. Elements may have attributes associated with them; since the Element interface inherits from Node, the generic Node interface attribute attributes may be used to retrieve the set of all attributes for an element. There are methods on the Element interface to retrieve either an Attr object by name or an attribute value by name. In XML, where an attribute value may contain entity references, an Attr object should be retrieved to examine the possibly fairly complex sub-tree representing the attribute value. On the other hand, in HTML, where all attributes have simple string values, methods to directly access an attribute value can safely be used as a convenience.

Note: In DOM Level 2, the method normalize is inherited from the Node interface where it was moved.

See also the Document Object Model (DOM) Level 3 Core Specification.

Field Summary

Fields inherited from interface org.w3c.dom.Node

ATTRIBUTE_NODE , CDATA_SECTION_NODE , COMMENT_NODE , DOCUMENT_FRAGMENT_NODE , DOCUMENT_NODE , DOCUMENT_POSITION_CONTAINED_BY , DOCUMENT_POSITION_CONTAINS , DOCUMENT_POSITION_DISCONNECTED , DOCUMENT_POSITION_FOLLOWING , DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC , DOCUMENT_POSITION_PRECEDING , DOCUMENT_TYPE_NODE , ELEMENT_NODE , ENTITY_NODE , ENTITY_REFERENCE_NODE , NOTATION_NODE , PROCESSING_INSTRUCTION_NODE , TEXT_NODE

Method Summary

String	getAttribute (String name) Retrieves an attribute value by name.
Attr	getAttributeNode (String name) Retrieves an attribute node by name.
Attr	getAttributeNodeNS (String namespaceURI, String localName) Retrieves an Attr node by local name and namespace URI.
String	getAttributeNS (String namespaceURI, String localName) Retrieves an attribute value by local name and namespace URI.
NodeList	getElementsByTagName (String name) Returns a NodeList of all descendant Elements with a given tag name, in document order.
NodeList	getElementsByTagNameNS (String namespaceURI, String localName) Returns a NodeList of all the descendant Elements with a given local name and namespace URI in document order.
TypeInfo	getSchemaTypeInfo () The type information associated with this element.
String	getTagName () The name of the element.
boolean	hasAttribute (String name) Returns true when an attribute with a given name is specified on this element or has a default value, false otherwise.
boolean	hasAttributeNS (String namespaceURI, String localName) Returns true when an attribute with a given local name and namespace URI is specified on this element or has a default value, false otherwise.
void	removeAttribute (String name) Removes an attribute by name.
Attr	removeAttributeNode (Attr oldAttr) Removes the specified attribute node.
void	removeAttributeNS (String namespaceURI, String localName) Removes an attribute by local name and namespace URI.
void	setAttribute (String name, String value) Adds a new attribute.
Attr	setAttributeNode (Attr newAttr) Adds a new attribute node.
Attr	setAttributeNodeNS (Attr newAttr) Adds a new attribute.
void	setAttributeNS (String namespaceURI, String qualifiedName, String value) Adds a new attribute.
void	setIdAttribute (String name, boolean isId) If the parameter isId is true, this method declares the specified attribute to be a user-determined ID attribute .
void	setIdAttributeNode (Attr idAttr, boolean isId) If the parameter isId is true, this method declares the specified attribute to be a user-determined ID attribute .
void	setIdAttributeNS (String namespaceURI, String localName, boolean isId) If the parameter isId is true, this method declares the specified attribute to be a user-determined ID attribute .

Methods inherited from interface org.w3c.dom.Node

appendChild , cloneNode , compareDocumentPosition , getAttributes , getBaseURI , getChildNodes , getFeature , getFirstChild , getLastChild , getLocalName , getNamespaceURI , getNextSibling , getNodeName , getNodeType , getNodeValue , getOwnerDocument , getParentNode , getPrefix , getPreviousSibling , getTextContent , getUserData , hasAttributes , hasChildNodes , insertBefore , isDefaultNamespace , isEqualNode , isSameNode , isSupported , lookupNamespaceURI , lookupPrefix , normalize , removeChild , replaceChild , setNodeValue , setPrefix , setTextContent , setUserData

Method Detail

getTagName

String    getTagName()

The name of the element. If Node.localName is different from null, this attribute is a qualified name. For example, in:

 <elementExample id="demo"> ... 
 </elementExample> , 

tagName has the value "elementExample". Note that this is case-preserving in XML, as are all of the operations of the DOM. The HTML DOM returns the tagName of an HTML element in the canonical uppercase form, regardless of the case in the source HTML document.

getAttribute

String    getAttribute(String    name)

Retrieves an attribute value by name.

Parameters:

name - The name of the attribute to retrieve.

Returns:

The Attr value as a string, or the empty string if that attribute does not have a specified or