La classe DOMNode

(PHP 5, PHP 7, PHP 8)

Synopsis de la 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;
/* Propriétés */
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éthodes */
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 pré-définies

DOMNode::DOCUMENT_POSITION_DISCONNECTED
Défini lorsque l'autre nœud et le nœud de référence ne sont pas dans le même arbre.
DOMNode::DOCUMENT_POSITION_PRECEDING
Défini lorsque l'autre nœud précède le nœud de référence.
DOMNode::DOCUMENT_POSITION_FOLLOWING
Défini lorsque l'autre nœud suit le nœud de référence.
DOMNode::DOCUMENT_POSITION_CONTAINS
Défini lorsque l'autre nœud est un ancêtre du nœud de référence.
DOMNode::DOCUMENT_POSITION_CONTAINED_BY
Défini lorsque l'autre nœud est un descendant du nœud de référence.
DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC
Défini lorsque le résultat dépend d'un comportement spécifique à l'implémentation et peut ne pas être portable. Cela peut se produire avec des nœuds déconnectés ou avec des nœuds attributs.

Propriétés

nodeName

Retourne le nom, le plus précis, pour le type de nœud courant

nodeValue

La valeur de ce nœud, suivant son type. Contrairement aux spécifications W3C, la valeur du nœud des nœuds DOMElement est égale à DOMNode::textContent au lieu de null.

nodeType

Récupère le type du nœud. Une des constantes XML_*_NODE

parentNode

Le parent de ce nœud. Si ce type de nœud n'existe pas, ceci retournera null.

parentElement

L'élément pare de cet élément. S'il n'y a pas de tel élément, ceci retourne null.

childNodes

Un DOMNodeList qui contient tous les enfants de ce nœud. S'il n'y a aucun enfant, ce sera un DOMNodeList vide.

firstChild

Le premier enfant de ce nœud. S'il n'y a aucun nœud de ce type, retourne null.

lastChild

Le dernier enfant de ce nœud. S'il n'y a aucun nœud de ce type, retourne null.

previousSibling

Le nœud précédant immédiatement ce nœud. S'il n'y a aucun nœud, retourne null.

nextSibling

Le nœud suivant immédiatement ce nœud. S'il n'y a aucun nœud, retourne null.

attributes

Un DOMNamedNodeMap contenant les attributs de ce nœud (si c'est un DOMElement) ou null sinon.

isConnected

Si le nœud est connecté à un document ou non

ownerDocument

L'objet DOMDocument associé avec ce nœud, ou null si ce nœud est un DOMDocument.

namespaceURI

L'espace de nom de l'URL pour ce nœud, ou null s'il n'est pas spécifié.

prefix

Le préfixe de l'espace de nom de ce nœud.

localName

Retourne la partie locale du nom qualifié du nœud.

baseURI

La base de l'URL absolue du nœud, ou null si l'implémentation n'a pas réussi à obtenir l'URL absolue.

textContent

Le contenu textuel de ce nœud et de ces descendants.

Historique

Version Description
8.4.0 La méthode DOMNode::compareDocumentPosition() a été ajoutée.
8.4.0 Les constantes DOMNode::DOCUMENT_POSITION_DISCONNECTED, DOMNode::DOCUMENT_POSITION_PRECEDING, DOMNode::DOCUMENT_POSITION_FOLLOWING, DOMNode::DOCUMENT_POSITION_CONTAINS, DOMNode::DOCUMENT_POSITION_CONTAINED_BY, et DOMNode::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC ont été ajoutées.
8.3.0 Les méthodes DOMNode::contains() et DOMNode::isEqualNode() ont été ajoutées.
8.3.0 Les propriétés DOMNode::$parentElement, et DOMNode::$isConnected ont été ajouté.
8.0.0 Les méthodes non implémentées DOMNode::compareDocumentPosition(), DOMNode::isEqualNode(), DOMNode::getFeature(), DOMNode::setUserData() et DOMNode::getUserData() ont été supprimées.

Notes

Note:

L'extension DOM utilise l'encodage UTF-8. Utilisez mb_convert_encoding(), UConverter::transcode(), ou iconv() pour manipuler d'autres encodages.

Sommaire