public DOMNode::C14N(
    bool $exclusive = false,
    bool $withComments = false,
    ?array $xpath = null,
    ?array $nsPrefixes = null
): string|false

public DOMNode::C14NFile(
    string $uri,
    bool $exclusive = false,
    bool $withComments = false,
    ?array $xpath = null,
    ?array $nsPrefixes = null
): int|false

public DOMNode::cloneNode(bool $deep = false): DOMNode|false

public DOMNode::compareDocumentPosition(DOMNode $other): int

public DOMNode::contains(DOMNode|DOMNameSpaceNode|null $other): bool

public DOMNode::getLineNo(): int

public DOMNode::getNodePath(): ?string

public DOMNode::getRootNode(?array $options = null): DOMNode

public DOMNode::hasAttributes(): bool

public DOMNode::hasChildNodes(): bool

public DOMNode::insertBefore(DOMNode $node, ?DOMNode $child = null): DOMNode|false

public DOMNode::isDefaultNamespace(string $namespace): bool

public DOMNode::isEqualNode(?DOMNode $otherNode): bool

public DOMNode::isSameNode(DOMNode $otherNode): bool

public DOMNode::isSupported(string $feature, string $version): bool

public DOMNode::lookupNamespaceURI(?string $prefix): ?string

public DOMNode::lookupPrefix(string $namespace): ?string

public DOMNode::normalize(): void

public DOMNode::removeChild(DOMNode $child): DOMNode|false

public DOMNode::replaceChild(DOMNode $node, DOMNode $child): DOMNode|false

public DOMNode::__sleep(): array

public DOMNode::__wakeup(): void

}

Propriétés

childElementCount: Le nombre d'éléments enfants.
firstElementChild: Premier élément enfant ou null.
lastElementChild: Dernier élément enfant ou null.
nextElementSibling: L'élément frère suivant ou null.
previousElementSibling: L'élément frère précédent ou null.
schemaTypeInfo: Pas encore implémenté, retourne toujours null
tagName: Le nom de l'élément
className: Une chaîne représentant les classes de l'élément, séparé par des espaces.
id: Reflète l'ID de l'élément via l'attribut "id".

Historique

Version	Description
8.0.0	Les propriétés `firstElementChild`, `lastElementChild`, `childElementCount`, `previousElementSibling` et `nextElementSibling` ont été ajoutées.
8.0.0	DOMElement implémente désormais DOMParentNode et DOMChildNode.

Notes

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

Sommaire

DOMElement::after — Ajoute des noeuds après l'élément
DOMElement::append — Ajoute des noeuds après le dernier enfant
DOMElement::before — Ajoute des noeuds avant l'élément
DOMElement::__construct — Crée un nouvel objet DOMElement
DOMElement::getAttribute — Retourne la valeur d'un attribut
DOMElement::getAttributeNames — Renvoie les noms des attributs
DOMElement::getAttributeNode — Retourne le nœud d'attribut
DOMElement::getAttributeNodeNS — Retourne le nœud d'attribut
DOMElement::getAttributeNS — Retourne la valeur de l'attribut
DOMElement::getElementsByTagName — Retourne les éléments par leur nom de balise
DOMElement::getElementsByTagNameNS — Récupère les éléments par leur espace de noms et leur localName
DOMElement::hasAttribute — Vérifie si un attribut existe
DOMElement::hasAttributeNS — Vérifie si un attribut existe
DOMElement::insertAdjacentElement — Insère un élément adjacent
DOMElement::insertAdjacentText — Insère un texte adjacent
DOMElement::prepend — Ajoute des noeuds avant le premier enfant
DOMElement::remove — Enlève l'élément
DOMElement::removeAttribute — Efface un attribut
DOMElement::removeAttributeNode — Efface un attribut
DOMElement::removeAttributeNS — Efface un attribut
DOMElement::replaceChildren — Remplace les enfants dans l'élément
DOMElement::replaceWith — Remplace l'élément par de nouveaux nœuds
DOMElement::setAttribute — Ajoute un nouvel attribut, ou modifie un attribut existant
DOMElement::setAttributeNode — Ajoute un nouvel attribut à l'élément
DOMElement::setAttributeNodeNS — Ajoute un nouvel attribut à l'élément
DOMElement::setAttributeNS — Ajoute un nouvel attribut
DOMElement::setIdAttribute — Déclare l'attribut spécifié par son nom à être de type ID
DOMElement::setIdAttributeNode — Déclare l'attribut spécifié par le nœud à être de type ID
DOMElement::setIdAttributeNS — Déclare l'attribut spécifié par son nom local et son espace de nom URI à être de type ID
DOMElement::toggleAttribute — Bascule l'attribut

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 13 notes

down

118

j DOT wagner ( AT ) medieninnovation.com ¶

16 years ago

Caveat!
It took me almost an hour to figure this out, so I hope it saves at least one of you some time.

If you want to debug your DOM tree and try var_dump() or similar you will be fooled into thinking the DOMElement that you are looking at is empty, because var_dump() says: object(DOMElement)#1 (0) { } 

After much debugging I found out that all DOM objects are invisible to var_dump() and print_r(), my guess is because they are C objects and not PHP objects. So I tried saveXML(), which works fine on DOMDocument, but is not implemented on DOMElement.

The solution is simple (if you know it):
$xml = $domElement->ownerDocument->saveXML($domElement);

This will give you an XML representation of $domElement.

down

Pinochet ¶

16 years ago

Hi to get the value of DOMElement just get the nodeValue public parameter (it is inherited from DOMNode):
<?php 
echo $domElement->nodeValue; 
?>
Everything is obvious if you now about this thing ;-)

down

Janne Enberg ¶

11 years ago

This page doesn't list the inherited properties from DOMNode, e.g. the quite important textContent property. It would be immensely helpful if it would list those as well.

down

dpetroff ( at ) gmail.com ¶

14 years ago

Hi!



Combining all th comments, the easiest way to get inner HTML of the node is to use this function:



<?php

function get_inner_html( $node ) {

    $innerHTML= '';

    $children = $node->childNodes;

    foreach ($children as $child) {

        $innerHTML .= $child->ownerDocument->saveXML( $child );

    }



    return $innerHTML;

}

?>

down

Daniel Morlock ¶

15 years ago

It would be nice to have a function which converts a document/node/element into a string. 

Anyways, I use the following code snippet to get the innerHTML value of a DOMNode:

<?php
function getInnerHTML($Node)
{
     $Body = $Node->ownerDocument->documentElement->firstChild->firstChild;
     $Document = new DOMDocument();     
     $Document->appendChild($Document->importNode($Body,true));
     return $Document->saveHTML();
}
?>

down

felix dot klee at inka dot de ¶

11 years ago

How to rename an element and preserve attributes:

<?php

// Changes the name of element $element to $newName.
function renameElement($element, $newName) {
  $newElement = $element->ownerDocument->createElement($newName);
  $parentElement = $element->parentNode;
  $parentElement->insertBefore($newElement, $element);

  $childNodes = $element->childNodes;
  while ($childNodes->length > 0) {
    $newElement->appendChild($childNodes->item(0));
  }

  $attributes = $element->attributes;
  while ($attributes->length > 0) {
    $attribute = $attributes->item(0);
    if (!is_null($attribute->namespaceURI)) {
      $newElement->setAttributeNS('http://www.w3.org/2000/xmlns/',
                                  'xmlns:'.$attribute->prefix,
                                  $attribute->namespaceURI);
    }
    $newElement->setAttributeNode($attribute);
  }

  $parentElement->removeChild($element);
}
 
function prettyPrint($d) {
  $d->formatOutput = true;
  echo '<pre>'.htmlspecialchars($d->saveXML()).'</pre>';
}

$d = new DOMDocument( '1.0' );
$d->loadXML('<?xml version="1.0"?>
<library>
  <data a:foo="1" x="bar" xmlns:a="http://example.com/a">
    <invite>
      <username>jmansa</username>
      <userid>1</userid>
    </invite>
    <update>1</update>
  </data>
</library>');

$xpath = new DOMXPath($d);
$elements = $xpath->query('/library/data');
if ($elements->length == 1) {
  $element = $elements->item(0);
  renameElement($element, 'invites');
}

prettyPrint($d);

?>

down

patrick smith ¶

16 years ago

Although it may be preferable to use the dom to manipulate elements, sometimes it's useful to actually get the innerHTML from a document element (e.g. to load into a client-side editor).



To get the innerHTML of a specific element ($elem_id) in a specific html file ($filepath):



<?php

$innerHTML = '';

$doc = new DOMDocument();

$doc->loadHTMLFile($filepath);    

$elem = $doc->getElementById($elem_id);



// loop through all childNodes, getting html        

$children = $elem->childNodes;

foreach ($children as $child) {

    $tmp_doc = new DOMDocument();

    $tmp_doc->appendChild($tmp_doc->importNode($child,true));        

    $innerHTML .= $tmp_doc->saveHTML();

}

?>

down

ae.fxx ¶

16 years ago

Hi there.

Remember to append a DOMNode (or any of its descendants) to a DOMDocument __BEFORE__ you try to append a child to it.

I don't know why it has to be this way but it can't be done without it.

bye

down

johnny ¶

10 years ago

Get html of a node
 $html .= $dom->saveHTML($node);

down

Anonymous ¶

14 years ago

you can use DOMNode::nodeValue
DOMElement inherits this public property.

$elem->nodeValue

down

loopduplicate at burningtoken dot com ¶

13 years ago

This works perfect for me as well:



<?php $xml = $domElement->ownerDocument->saveXML($domElement); ?>

down

nawaman at gmail dot com ¶

15 years ago

The following code shows can text-only content be extracted from a document.



<?php

function getTextFromNode($Node, $Text = "") {

    if ($Node->tagName == null)

        return $Text.$Node->textContent;



    $Node = $Node->firstChild;

    if ($Node != null)

        $Text = getTextFromNode($Node, $Text);



    while($Node->nextSibling != null) {

        $Text = getTextFromNode($Node->nextSibling, $Text);

        $Node = $Node->nextSibling;

    }

    return $Text;

}



function getTextFromDocument($DOMDoc) {

    return getTextFromNode($DOMDoc->documentElement);

}



$Doc = new DOMDocument();

$Doc->loadHTMLFile("Test.html");

echo getTextFromDocument($Doc)."\n";

?>

down

-3

Severin ¶

16 years ago

I wanted to find similar Elements - thats why I built an Xpath-String like this - maybe somebody needs it... its not very pretty - but neither is domdocument :)



<?php



$dom->load($xmlFile))



$xpathQuery = '//*';

$xmlNodes = $xpath->query($xpathQuery);

        

$pathlist = array();

$attrlist = array();

foreach ($xmlNodes as $node) {



  $depth = $this->_getDomDepth($node);   //get Path-Depth (for array key)

  $pathlist[$depth] = $node->tagName;     // tagname

          

  $attrs = $node->attributes;

  $attr='';

  $a=0;

  foreach ($attrs as $attrName => $attrNode)  // attributes

            {

              if ($attrName !='reg')

              {

                if ($a++!=0) $attr .= ' and ';

                $attr .= '@'.$attrName.'='."'".$attrNode->value."'";

              }

            }

          

          $attrlist[$depth] = $attr?'['.$attr.']':'';

          

          $path = ''; for ($i=0;$i<=$depth;$i++) $path .= '/'.$pathlist[$i].$attrlist[$i];  // the xpath of the actual Element



    // ... now you can go on and user $path to find similar elements

    }

  }

}



 private function _getDomDepth(DomNode $node)

   {

     $r = -2;

     while ($node) {

       $r++;  

       $node = $node->parentNode;

     } 

     return  $r;

   }

?>

＋add a note