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 $namespaceURI): 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 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

Tabla de contenidos