La clase DOMNode

(PHP 5, PHP 7, PHP 8)

Sinopsis de la Clase

class DOMNode {

/* Constantes */

public const int DOCUMENT_POSITION_DISCONNECTED = 0x1;

public const int DOCUMENT_POSITION_PRECEDING = 0x2;

public const int DOCUMENT_POSITION_FOLLOWING = 0x4;

public const int DOCUMENT_POSITION_CONTAINS = 0x8;

public const int DOCUMENT_POSITION_CONTAINED_BY = 0x10;

public const int DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;

/* Propiedades */

public readonly string $nodeName;

public ?string $nodeValue;

public readonly int $nodeType;

public readonly ?DOMNode $parentNode;

public readonly ?DOMElement $parentElement;

public readonly DOMNodeList $childNodes;

public readonly ?DOMNode $firstChild;

public readonly ?DOMNode $lastChild;

public readonly ?DOMNode $previousSibling;

public readonly ?DOMNode $nextSibling;

public readonly ?DOMNamedNodeMap $attributes;

public readonly bool $isConnected;

public readonly ?DOMDocument $ownerDocument;

public readonly ?string $namespaceURI;

public string $prefix;

public readonly ?string $localName;

public readonly ?string $baseURI;

public string $textContent;

/* Métodos */

public appendChild(DOMNode $node): DOMNode|false

public C14N(
    bool $exclusive = false,
    bool $withComments = false,
    ?array $xpath = null,
    ?array $nsPrefixes = null
): string|false

public C14NFile(
    string $uri,
    bool $exclusive = false,
    bool $withComments = false,
    ?array $xpath = null,
    ?array $nsPrefixes = null
): int|false

public cloneNode(bool $deep = false): DOMNode|false

public compareDocumentPosition(DOMNode $other): int

public contains(DOMNode|DOMNameSpaceNode|null $other): bool

public getLineNo(): int

public getNodePath(): ?string

public getRootNode(?array $options = null): DOMNode

public hasAttributes(): bool

public hasChildNodes(): bool

public insertBefore(DOMNode $node, ?DOMNode $child = null): DOMNode|false

public isDefaultNamespace(string $namespace): bool

public isEqualNode(?DOMNode $otherNode): bool

public isSameNode(DOMNode $otherNode): bool

public isSupported(string $feature, string $version): bool

public lookupNamespaceURI(?string $prefix): ?string

public lookupPrefix(string $namespace): ?string

public normalize(): void

public removeChild(DOMNode $child): DOMNode|false

public replaceChild(DOMNode $node, DOMNode $child): DOMNode|false

public __sleep(): array

public __wakeup(): void

}

Constantes predefinidas

DOMNode::DOCUMENT_POSITION_DISCONNECTED: Definido cuando el otro nódo y el nódo de referencia no están en el mismo árbol.
DOMNode::DOCUMENT_POSITION_PRECEDING: Definido cuando el otro nódo precede al nódo de referencia.
DOMNode::DOCUMENT_POSITION_FOLLOWING: Definido cuando el otro nódo sigue al nódo de referencia.
DOMNode::DOCUMENT_POSITION_CONTAINS: Definido cuando el otro nódo es un ancestro del nódo de referencia.
DOMNode::DOCUMENT_POSITION_CONTAINED_BY: Definido cuando el otro nódo es un descendiente del nódo de referencia.
DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: Definido cuando el resultado depende de un comportamiento específico de la implementación y puede no ser portable. Esto puede ocurrir con nódulos desconectados o con nódulos de atributos.

Propiedades

nodeName: Devuelve el nombre más preciso para el tipo de nódo actual.
nodeValue: El valor de este nódo, según su tipo. A diferencia de las especificaciones W3C, el valor del nódo de los nódulos DOMElement es igual a DOMNode::textContent en lugar de null.
nodeType: Recupera el tipo del nódo. Una de las constantes predefinidas XML_*_NODE
parentNode: El padre de este nódo. Si este tipo de nódo no existe, esto devolverá null.
parentElement: El elemento padre de este elemento. Si no hay tal elemento, esto devuelve null.
childNodes: Un DOMNodeList que contiene todos los hijos de este nódo. Si no hay hijos, será un DOMNodeList vacío.
firstChild: El primer hijo de este nódo. Si no hay nódo de este tipo, devuelve null.
lastChild: El último hijo de este nódo. Si no hay nódo de este tipo, devuelve null.
previousSibling: El nódo que precede inmediatamente a este nódo. Si no hay nódo, devuelve null.
nextSibling: El nódo que sigue inmediatamente a este nódo. Si no hay nódo, devuelve null.
attributes: Un DOMNamedNodeMap que contiene los atributos de este nódo (si es un DOMElement) o null en caso contrario.
isConnected: Si el nódo está conectado a un documento o no.
ownerDocument: El objeto DOMDocument asociado con este nódo, o null si este nódo no tiene un documento asociado (p. ej., si está separado o es un DOMDocument).
namespaceURI: El espacio de nombres de la URL para este nódo, o null si no está especificado.
prefix: El prefijo del espacio de nombres de este nódo.
localName: Devuelve la parte local del nombre cualificado del nódo.
baseURI: La base de la URL absoluta del nódo, o null si la implementación no ha logrado obtener la URL absoluta.
textContent: El contenido textual de este nódo y sus descendientes.

Historial de cambios

Versión	Descripción
8.4.0	El método DOMNode::compareDocumentPosition() ha sido añadido.
8.4.0	Las constantes `DOMNode::DOCUMENT_POSITION_DISCONNECTED`, `DOMNode::DOCUMENT_POSITION_PRECEDING`, `DOMNode::DOCUMENT_POSITION_FOLLOWING`, `DOMNode::DOCUMENT_POSITION_CONTAINS`, `DOMNode::DOCUMENT_POSITION_CONTAINED_BY`, y `DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC` han sido añadidas.
8.3.0	Los métodos DOMNode::contains() y DOMNode::isEqualNode() han sido añadidos.
8.3.0	Las propiedades DOMNode::$parentElement, y DOMNode::$isConnected han sido añadidas.
8.0.0	Los métodos no implementados DOMNode::compareDocumentPosition(), DOMNode::isEqualNode(), DOMNode::getFeature(), DOMNode::setUserData() y DOMNode::getUserData() han sido eliminados.

Notas

Nota:
La extensión DOM utiliza el codificado UTF-8. Utilice mb_convert_encoding(), UConverter::transcode(), o iconv() para manipular otros codificados.

Ver también

» La especificación W3C de un nódo

Tabla de contenidos

DOMNode::appendChild — Añade un nuevo hijo al final de los hijos
DOMNode::C14N — Canoniza nodos en una cadena
DOMNode::C14NFile — Canoniza nodos en archivo
DOMNode::cloneNode — Clona un nodo
DOMNode::compareDocumentPosition — Comparar la posición de dos nodos
DOMNode::contains — Verifica si un nodo contiene otro nodo
DOMNode::getLineNo — Obtiene el número de línea de un nodo
DOMNode::getNodePath — Obtener un XPath de un nodo
DOMNode::getRootNode — Devuelve el nodo raíz
DOMNode::hasAttributes — Comprueba si un nodo tiene atributos
DOMNode::hasChildNodes — Comprueba si el nodo tiene hijos
DOMNode::insertBefore — Añade un nuevo hijo antes de un nodo de referencia.
DOMNode::isDefaultNamespace — Comprueba si la URI del espacio de nombres especificada es el espacio de nombres predeterminado
DOMNode::isEqualNode — Comprueba si los dos nodos son iguales
DOMNode::isSameNode — Indica si dos nodos son el mismo nodo
DOMNode::isSupported — Comprueba si una característica está soportada para la versión especificada
DOMNode::lookupNamespaceURI — Obtiene la URI del espacio de nombres del nodo basado en el prefijo
DOMNode::lookupPrefix — Devuelve el prefijo del espacio de nombres según el URI del espacio de nombres
DOMNode::normalize — Normaliza el nodo
DOMNode::removeChild — Elimina un hijo de la lista de hijos
DOMNode::replaceChild — Reemplaza un hijo
DOMNode::__sleep — Prohíbe la serialización a menos que los métodos de serialización se implementen en una subclase
DOMNode::__wakeup — Prohíbe la deserialización a menos que los métodos de deserialización estén implementados en una subclase