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;
/* Propriedades */
public readonly string $nodeName;
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;
/* Métodos */
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 getLineNo(): int
public getRootNode(?array $options = null): DOMNode
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 lookupPrefix(string $namespace): ?string
public normalize(): void
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ó 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.

Índice