Node
Node
es una interfaz en la cuál un número de objetos de tipo DOM API heredan. Esta interfaz permite que esos objetos sean tratados similarmente.
Las siguientes interfaces todas heredan de los metodos y propiedades de Node
: Document
, Element
, CharacterData
(en-US) (heredan el Text
(en-US), el Comment
, y CDATASection
(en-US)), ProcessingInstruction
(en-US), DocumentFragment
, DocumentType
(en-US), Notation
, Entity
, EntityReference
Estas interfaces pueden retornar null en casos particulares donde los métodos y las propiedades no son relevantes. Pueden retornar una excepción - por ejemplo cuando se agregan hijos a un tipo de node del cuál no puede existir hijos.
Propiedades
herendan propiedades de sus padres EventTarget
.[1]
Node.baseURI
(en-US) Read only-
Retorna un
DOMString
representando la base de la URL. El concepto de la base de la URL cambia de un lenguaje a otro; en HTML, le corresponde al protocolo, el nombre del dominio y la estructura del directorio, eso es todo hasta el último'/'
. Node.baseURIObject
(en-US) Non-standard-
(Not available to web content.) The read-only
nsIURI
object representing the base URI for the element. Node.childNodes
Read only-
Returns a live
NodeList
containing all the children of this node.NodeList
being live means that if the children of theNode
change, theNodeList
object is automatically updated. Node.firstChild
(en-US) Read only-
Returns a
Node
representing the first direct child node of the node, ornull
if the node has no child. Node.lastChild
Read only-
Returns a
Node
representing the last direct child node of the node, ornull
if the node has no child. Node.localName
(en-US) Obsoleto Read only-
Returns a
DOMString
representing the local part of the qualified name of an element. In Firefox 3.5 and earlier, the property upper-cases the local name for HTML elements (but not XHTML elements). In later versions, this does not happen, so the property is in lower case for both HTML and XHTML. Though recent specifications requirelocalName
to be defined on theElement
interface, Gecko-based browsers still implement it on theNode
interface. Node.namespaceURI
(en-US) Obsoleto Read only-
The namespace URI of this node, or
null
if it is no namespace. In Firefox 3.5 and earlier, HTML elements are in no namespace. In later versions, HTML elements are in thehttp://www.w3.org/1999/xhtml
namespace in both HTML and XML trees. Though recent specifications requirenamespaceURI
to be defined on theElement
interface, Gecko-based browsers still implement it on theNode
interface. Node.nextSibling
Read only-
Returns a
Node
representing the next node in the tree, ornull
if there isn't such node. Node.nodeName
Read only-
Returns a
DOMString
containing the name of theNode
. The structure of the name will differ with the name type. E.g. AnHTMLElement
will contain the name of the corresponding tag, like'audio'
for anHTMLAudioElement
, aText
(en-US) node will have the'#text'
string, or aDocument
node will have the'#document'
string. Node.nodePrincipal
(en-US) Non-standard-
A
nsIPrincipal
representing the node principal. Node.nodeType
Read only-
Returns an
unsigned short
representing the type of the node. Possible values are:Name Value ELEMENT_NODE
1
ATTRIBUTE_NODE
Obsoleto2
TEXT_NODE
3
CDATA_SECTION_NODE
Obsoleto4
ENTITY_REFERENCE_NODE
Obsoleto5
ENTITY_NODE
Obsoleto6
PROCESSING_INSTRUCTION_NODE
7
COMMENT_NODE
8
DOCUMENT_NODE
9
DOCUMENT_TYPE_NODE
10
DOCUMENT_FRAGMENT_NODE
11
NOTATION_NODE
Obsoleto12
Node.nodeValue
-
Is a
DOMString
representing the value of an object. For mostNode
type, this returnsnull
and any set operation is ignored. For nodes of typeTEXT_NODE
(Text
(en-US) objects),COMMENT_NODE
(Comment
objects), andPROCESSING_INSTRUCTION_NODE
(ProcessingInstruction
(en-US) objects), the value corresponds to the text data contained in the object. Node.ownerDocument
Read only-
Returns the
Document
that this node belongs to. If no document is associated with it, returnsnull
. Node.parentNode
Read only-
Returns a
Node
that is the parent of this node. If there is no such node, like if this node is the top of the tree or if doesn't participate in a tree, this property returnsnull
. Node.parentElement
Read only-
Returns an
Element
that is the parent of this node. If the node has no parent, or if that parent is not anElement
, this property returnsnull
. Node.prefix
(en-US) Obsoleto Read only-
Is a
DOMString
representing the namespace prefix of the node, ornull
if no prefix is specified. Though recent specifications requireprefix
to be defined on theElement
interface, Gecko-based browsers still implement it on theNode
interface. Node.previousSibling
Read only-
Returns a
Node
representing the previous node in the tree, ornull
if there isn't such node. Node.textContent
-
Is a
DOMString
representing the textual content of an element and all its descendants.
Methods
Inherits methods from its parents EventTarget
.[1]
Node.appendChild()
-
Insert a
Node
as the last child node of this element. Node.cloneNode()
-
Clone a
Node
, and optionally, all of its contents. By default, it clones the content of the node. Node.compareDocumentPosition()
(en-US)-
Empty
Node.contains()
-
Empty
Node.getFeature()
Obsoleto-
...
Node.getUserData()
Obsoleto-
Allows a user to get some
DOMUserData
from the node. Node.hasAttributes()
Obsoleto-
Returns a
Boolean
(en-US) indicating if the element has any attributes, or not. Node.hasChildNodes()
-
Returns a
Boolean
(en-US) indicating if the element has any child nodes, or not. Node.insertBefore()
-
Inserts the first
Node
given in a parameter immediately before the second, child of this element,Node
. Node.isDefaultNamespace()
(en-US)-
Empty
Node.isEqualNode()
(en-US)-
Empty
Node.isSameNode()
Obsoleto-
Empty
Node.isSupported()
(en-US) Obsoleto-
Returns a
Boolean
(en-US) flag containing the result of a test whether the DOM implementation implements a specific feature and this feature is supported by the specific node. Node.lookupPrefix()
(en-US)-
Empty
Node.lookupNamespaceURI()
(en-US)-
Empty
Node.normalize()
(en-US)-
Clean up all the text nodes under this element (merge adjacent, remove empty).
Node.removeChild()
-
Removes a child node from the current element, which must be a child of the current node.
Node.replaceChild()
-
Replaces one child
Node
of the current one with the second one given in parameter. Node.setUserData()
Obsoleto-
Allows a user to attach, or remove,
DOMUserData
to the node.
Examples
Browse all child nodes
The following function recursively cycles all child nodes of a node and executes a callback function upon them (and upon the parent node itself).
function DOMComb (oParent, oCallback) {
if (oParent.hasChildNodes()) {
for (var oNode = oParent.firstChild; oNode; oNode = oNode.nextSibling) {
DOMComb(oNode, oCallback);
}
}
oCallback.call(oParent);
}
Syntax
DOMComb(parentNode, callbackFunction);
Description
Recursively cycle all child nodes of parentNode
and parentNode
itself and execute the callbackFunction
upon them as this
objects.
Parameters
parentNode
-
The parent node (
Node Object
). callbackFunction
-
The callback function (
Function
(en-US)).
Sample usage
The following example send to the console.log
the text content of the body:
function printContent () {
if (this.nodeValue) { console.log(this.nodeValue); }
}
onload = function () {
DOMComb(document.body, printContent);
};
Remove all children nested within a node
Element.prototype.removeAll = function () {
while (this.firstChild) { this.removeChild(this.firstChild); }
return this;
};
Sample usage
/* ... an alternative to document.body.innerHTML = "" ... */
document.body.removeAll();
Especificaciones
Specification |
---|
DOM Standard # interface-node |
Compatibilidad con navegadores
BCD tables only load in the browser