A classe DOMNode

(PHP 5, PHP 7, PHP 8)

Resumo da classe

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;

/* Propriedades */

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 quando o outro nó e o nó de referência não estão na mesma árvore.
DOMNode::DOCUMENT_POSITION_PRECEDING: Definido quando o outro nó precede o nó de referência.
DOMNode::DOCUMENT_POSITION_FOLLOWING: Definido quando o outro nó segue o nó de referência.
DOMNode::DOCUMENT_POSITION_CONTAINS: Definido quando o outro nó é um ancestral do nó de referência.
DOMNode::DOCUMENT_POSITION_CONTAINED_BY: Definido quando o outro nó é descendente do nó de referência.
DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: Definido quando o resultado depende do comportamento específico da implementação e pode não ser portável. Isto pode acontecer com nós desconectados ou com nós de atributos.

Propriedades

nodeName: Retorna o nome mais preciso para o tipo atual de nó
nodeValue: O valor deste nó, dependendo do seu tipo. Contrariamente à especificação do W3C, o valor do nó de DOMElement é igual a DOMNode::textContent em vez de null.
nodeType: Obtém o tipo do nó. Um dos constantes predefinidas XML_*_NODE
parentNode: O pai deste nó. Se não houver tal nó, isso retorna null.
parentElement: O elemento pai deste elemento. Se não houver tal elemento, isso retorna null.
childNodes: Um DOMNodeList que contém todos os filhos deste nó. Se não houver filhos, isso é um DOMNodeList vazio.
firstChild: O primeiro filho deste nó. Se não houver tal nó, isso retorna null.
lastChild: O último filho deste nó. Se não houver tal nó, isso retorna null.
previousSibling: O nó imediatamente anterior a este nó. Se não houver tal nó, isso retorna null.
nextSibling: O nó imediatamente seguinte a este nó. Se não houver tal nó, isso retorna null.
attributes: Um DOMNamedNodeMap que contém os atributos deste nó (se for um DOMElement) ou null caso contrário.
isConnected: Se o nó está conectado a um documento.
ownerDocument: O objeto DOMDocument associado a este nó, ou null se este nó não tiver um documento associado (por exemplo, se estiver destacado ou se for um DOMDocument).
namespaceURI: O URI do namespace deste nó, ou null se não estiver especificado.
prefix: O prefixo do namespace deste nó.
localName: Retorna a parte local do nome qualificado deste nó.
baseURI: O URI base absoluto deste nó, ou null se a implementação não conseguir obter um URI absoluto.
textContent: O conteúdo textual deste nó e de seus descendentes.

Registro de Alterações

Versão	Descrição
8.4.0	O método DOMNode::compareDocumentPosition() foi adicionado.
8.4.0	As constantes `DOMNode::DOCUMENT_POSITION_DISCONNECTED`, `DOMNode::DOCUMENT_POSITION_PRECEDING`, `DOMNode::DOCUMENT_POSITION_FOLLOWING`, `DOMNode::DOCUMENT_POSITION_CONTAINS`, `DOMNode::DOCUMENT_POSITION_CONTAINED_BY` e `DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC` foram adicionadas.
8.3.0	Os métodos DOMNode::contains() e DOMNode::isEqualNode() foram adicionados.
8.3.0	As propriedades DOMNode::$parentElement, e DOMNode::$isConnected foram adicionadas.
8.0.0	Os métodos não implementados DOMNode::compareDocumentPosition(), DOMNode::isEqualNode(), DOMNode::getFeature(), DOMNode::setUserData() e DOMNode::getUserData() foram removidos.

Notas

Nota:
A extensão DOM usa codificação UTF-8. Use mb_convert_encoding(), UConverter::transcode() ou iconv() para lidar com outras codificações.

Veja Também

» Especificação do W3C para Node

Índice

DOMNode::appendChild — Adiciona um novo filho ao final dos filhos
DOMNode::C14N — Canonicaliza nós para uma string
DOMNode::C14NFile — Canonicaliza nós para um arquivo
DOMNode::cloneNode — Clona um nó
DOMNode::compareDocumentPosition — Compara a posição de dois nós
DOMNode::contains — Verifica se o nó contém outro nó
DOMNode::getLineNo — Obtém o número da linha para um nó
DOMNode::getNodePath — Obtém um XPath para um nó
DOMNode::getRootNode — Obtém o nó raiz
DOMNode::hasAttributes — Verifica se o nó possui atributos
DOMNode::hasChildNodes — Verifica se o nó possui filhos
DOMNode::insertBefore — Adiciona um novo filho antes de um nó de referência
DOMNode::isDefaultNamespace — Verifica se o namespaceURI especificado é o namespace padrão ou não
DOMNode::isEqualNode — Verifica se ambos os nós são iguais
DOMNode::isSameNode — Indica se dois nós são o mesmo nó
DOMNode::isSupported — Verifica se o recurso é suportado para a versão especificada
DOMNode::lookupNamespaceURI — Obtém o URI do namespace do nó com base no prefixo
DOMNode::lookupPrefix — Obtém o prefixo do namespace do nó com base no URI do namespace
DOMNode::normalize — Normaliza o nó
DOMNode::removeChild — Remove um filho da lista de filhos
DOMNode::replaceChild — Substitui um filho
DOMNode::__sleep — Proíbe a serialização a menos que métodos de serialização estejam implementados em uma subclasse
DOMNode::__wakeup — Proíbe a desserialização a menos que métodos de desserialização estejam implementados em uma subclasse