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;
public const int DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;
/* Propriétés */
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éthodes */
public function appendChild(DOMNode $node): DOMNode|false
public function C14N(
    bool $exclusive = false,
    bool $withComments = false,
    ?array $xpath = null,
    ?array $nsPrefixes = null
): string|false
public function C14NFile(
    string $uri,
    bool $exclusive = false,
    bool $withComments = false,
    ?array $xpath = null,
    ?array $nsPrefixes = null
): int|false
public function cloneNode(bool $deep = false): DOMNode|false
public function compareDocumentPosition(DOMNode $other): int
public function contains(DOMNode|DOMNameSpaceNode|null $other): bool
public function getLineNo(): int
public function getNodePath(): ?string
public function getRootNode(?array $options = null): DOMNode
public function hasAttributes(): bool
public function hasChildNodes(): bool
public function insertBefore(DOMNode $node, ?DOMNode $child = null): DOMNode|false
public function isDefaultNamespace(string $namespace): bool
public function isEqualNode(?DOMNode $otherNode): bool
public function isSameNode(DOMNode $otherNode): bool
public function isSupported(string $feature, string $version): bool
public function lookupNamespaceURI(?string $prefix): ?string
public function lookupPrefix(string $namespace): ?string
public function normalize(): void
public function removeChild(DOMNode $child): DOMNode|false
public function replaceChild(DOMNode $node, DOMNode $child): DOMNode|false
public function __sleep(): array
public function __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 parent 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 n'a pas de document associé (par exemple, s'il est détaché, ou s'il s'agit d'un DOMDocument).

namespaceURI

L'URI du namespace de ce nœud, ou null s'il n'est pas spécifié.

prefix

Le préfixe du namespace de ce nœud.

localName

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

baseURI

L'URI de base absolu du nœud, ou null si l'implémentation n'a pas réussi à obtenir un URI absolu.

textContent

Le contenu textuel de ce nœud et de ses 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ées.
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.

Voir aussi

Sommaire