Submit a Pull Request Report a Bug

DOMElement クラス

(PHP 5, PHP 7, PHP 8)

クラス概要

class DOMElement extends DOMNode implements DOMParentNode, DOMChildNode {

/* プロパティ */

public readonly string $tagName;

public readonly mixed $schemaTypeInfo = null;

public readonly ?DOMElement $firstElementChild;

public readonly ?DOMElement $lastElementChild;

public readonly int $childElementCount;

public readonly ?DOMElement $previousElementSibling;

public readonly ?DOMElement $nextElementSibling;

/* 継承したプロパティ */

public readonly string $nodeName;

public ?string $nodeValue;

public readonly int $nodeType;

public readonly ?DOMNode $parentNode;

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 ?DOMDocument $ownerDocument;

public readonly ?string $namespaceURI;

public string $prefix;

public readonly ?string $localName;

public readonly ?string $baseURI;

public string $textContent;

/* メソッド */

public __construct(string $qualifiedName, ?string $value = null, string $namespace = "")

public getAttribute(string $qualifiedName): string

public getAttributeNode(string $qualifiedName): DOMAttr|DOMNameSpaceNode|false

public getAttributeNodeNS(?string $namespace, string $localName): DOMAttr|DOMNameSpaceNode|null

public getAttributeNS(?string $namespace, string $localName): string

public getElementsByTagName(string $qualifiedName): DOMNodeList

public getElementsByTagNameNS(?string $namespace, string $localName): DOMNodeList

public hasAttribute(string $qualifiedName): bool

public hasAttributeNS(?string $namespace, string $localName): bool

public removeAttribute(string $qualifiedName): bool

public removeAttributeNode(DOMAttr $attr): DOMAttr|false

public removeAttributeNS(?string $namespace, string $localName): void

public setAttribute(string $qualifiedName, string $value): DOMAttr|bool

public setAttributeNode(DOMAttr $attr): DOMAttr|null|false

public setAttributeNodeNS(DOMAttr $attr): DOMAttr|null|false

public setAttributeNS(?string $namespace, string $qualifiedName, string $value): void

public setIdAttribute(string $qualifiedName, bool $isId): void

public setIdAttributeNode(DOMAttr $attr, bool $isId): void

public setIdAttributeNS(string $namespace, string $qualifiedName, bool $isId): void

/* 継承したメソッド */

public DOMNode::appendChild(DOMNode $node): DOMNode|false

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::getLineNo(): int

public DOMNode::getNodePath(): ?string

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::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

}

プロパティ

childElementCount: 子要素の数。
firstElementChild: 最初の子要素。存在しない場合は null になります。
lastElementChild: 最後の子要素。存在しない場合は null になります。
nextElementSibling: 次の兄弟要素。存在しない場合は null になります。
previousElementSibling: 前の兄弟要素。存在しない場合は null になります。
schemaTypeInfo: 未実装。常に null を返す。
tagName: 要素名

変更履歴

バージョン	説明
8.0.0	プロパティ `firstElementChild`, `lastElementChild`, `childElementCount`, `previousElementSibling`, `nextElementSibling` が追加されました。
8.0.0	DOMElement は、 DOMParentNode と DOMChildNode を実装しました。

注意

注意:
DOM拡張モジュールは UTF-8 エンコーディングを使います。他のエンコーディングを扱う場合は、mb_convert_encoding(), UConverter::transcode(), iconv() を使ってください。

DOMElement::__construct — 新しい DOMElement オブジェクトを作成する
DOMElement::getAttribute — 属性の値を返す
DOMElement::getAttributeNode — 属性ノードを返す
DOMElement::getAttributeNodeNS — 属性ノードを返す
DOMElement::getAttributeNS — 属性の値を返す
DOMElement::getElementsByTagName — タグ名から要素を取得する
DOMElement::getElementsByTagNameNS — 名前空間 URI とローカル名から要素を取得する
DOMElement::hasAttribute — 属性が存在するかどうかを調べる
DOMElement::hasAttributeNS — 属性が存在するかどうかを調べる
DOMElement::removeAttribute — 属性を削除する
DOMElement::removeAttributeNode — 属性を削除する
DOMElement::removeAttributeNS — 属性を削除する
DOMElement::setAttribute — 属性を新しく追加する、または変更する
DOMElement::setAttributeNode — 新しい属性ノードを要素に追加する
DOMElement::setAttributeNodeNS — 新しい属性ノードを要素に追加する
DOMElement::setAttributeNS — 新しい属性を追加する
DOMElement::setIdAttribute — ID 型の属性を名前で宣言する
DOMElement::setIdAttributeNode — ID 型の属性をノードで宣言する
DOMElement::setIdAttributeNS — ID 型の属性をローカル名および名前空間 URI で宣言する

＋add a note

User Contributed Notes 13 notes

down

115

j DOT wagner ( AT ) medieninnovation.com ¶

14 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 ¶

14 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 ¶

9 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 ¶

12 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 ¶

14 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 ¶

10 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 ¶

14 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 ¶

14 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

nawaman at gmail dot com ¶

13 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

johnny ¶

9 years ago


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

down

loopduplicate at burningtoken dot com ¶

12 years ago


This works perfect for me as well:



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

down

Anonymous ¶

12 years ago


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

$elem->nodeValue

down

-4

Severin ¶

14 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

DOMElement クラス

クラス概要

プロパティ

変更履歴

注意

目次

User Contributed Notes 13 notes