support for bulk node manipulation using childnodes

Author: php-templates

src/Contracts/DomElementInterface.php

@@ -21,11 +21,11 @@ public function getNextSibling(): ?DomElementInterface;
 
     public function getChildNodes(): DomNodeIterator;
 
-    public function setParentNode(DomElementInterface $node = null): ?DomElementInterface;
+    public function setParentNode(DomElementInterface $node = null): DomElementInterface;
 
-    public function setPrevSibling(DomElementInterface $node = null): ?DomElementInterface;
+    public function setPrevSibling(DomElementInterface $node = null): DomElementInterface;
 
-    public function setNextSibling(DomElementInterface $node = null): ?DomElementInterface;
+    public function setNextSibling(DomElementInterface $node = null): DomElementInterface;
 
     /**
      * Append a new child node to current node.

src/DomNodeIterator.php

@@ -4,7 +4,7 @@
 
 use PhpTemplates\Dom\Contracts\DomElementInterface;
 
-class DomNodeIterator implements \Iterator
+class DomNodeIterator implements \Iterator, DomElementInterface
 {
     public ?DomElementInterface $head = null;
     private ?DomElementInterface $current = null;
@@ -105,4 +105,155 @@ public function __toString(): string
 
         return $output;
     }
+
+    public function getParentNode(): ?DomElementInterface
+    {
+        if ($this->head) {
+            return $this->head->getParentNode();
+        }
+    }
+
+    public function getPrevSibling(): ?DomElementInterface
+    {
+        if ($this->head) {
+            return $this->head->getPrevSibling();
+        }
+    }
+
+    public function getNextSibling(): ?DomElementInterface
+    {
+        if ($this->head) {
+            return $this->head->getNextSibling();
+        }
+    }
+
+    public function getChildNodes(): DomNodeIterator
+    {
+        if ($this->head) {
+            return $this->head->getChildNodes();
+        }
+
+        return new DomNodeIterator;
+    }
+
+    public function setParentNode(DomElementInterface $node = null): DomElementInterface
+    {
+        $this->rewind();
+        while ($elNode = $this->current) {
+            $this->next();
+            $elNode->setParentNode($node);
+        }
+
+        return $this;
+    }
+
+    public function setPrevSibling(DomElementInterface $node = null): DomElementInterface
+    {
+        $this->rewind();
+        while ($elNode = $this->current) {
+            $this->next();
+            $elNode->setPrevSibling($node);
+        }
+
+        return $this;
+    }
+
+    public function setNextSibling(DomElementInterface $node = null): DomElementInterface
+    {
+        $this->rewind();
+        while ($elNode = $this->current) {
+            $this->next();
+            $elNode->setNextSibling($node);
+        }
+
+        return $this;
+    }
+
+    public function appendChild(DomElementInterface $node): DomElementInterface
+    {
+        $this->rewind();
+        while ($elNode = $this->current) {
+            $this->next();
+            $elNode->appendChild($node);
+        }
+
+        return $this;
+    }
+
+    public function prependChild(DomElementInterface $node): DomElementInterface
+    {
+        $this->rewind();
+        while ($elNode = $this->current) {
+            $this->next();
+            $elNode->prependChild($node);
+        }
+
+        return $this;
+    }
+
+    public function insertBefore(DomElementInterface $node): DomElementInterface
+    {
+        $this->rewind();
+        while ($elNode = $this->current) {
+            $this->next();
+            $elNode->insertBefore($node);
+        }
+
+        return $this;
+    }
+
+    public function appendTo(DomElementInterface $node): DomElementInterface
+    {
+        $this->rewind();
+        while ($elNode = $this->current) {
+            $this->next();
+            $elNode->appendTo($node);
+        }
+
+        return $this;
+    }
+
+    public function insertAfter(DomElementInterface $node): DomElementInterface
+    {
+        $this->rewind();
+        while ($elNode = $this->current) {
+            $this->next();
+            $elNode->insertAfter($node);
+        }
+
+        return $this;
+    }
+
+    public function before(DomElementInterface $node): DomElementInterface
+    {
+        $this->rewind();
+        while ($elNode = $this->current) {
+            $this->next();
+            $elNode->before($node);
+        }
+
+        return $this;
+    }
+
+    public function after(DomElementInterface $node): DomElementInterface
+    {
+        $this->rewind();
+        while ($elNode = $this->current) {
+            $this->next();
+            $elNode->after($node);
+        }
+
+        return $this;
+    }
+
+    public function detach(): DomElementInterface
+    {
+        $this->rewind();
+        while ($elNode = $this->current) {
+            $this->next();
+            $elNode->detach();
+        }
+
+        return $this;
+    }
 }

src/Traits/DomElement.php

@@ -71,21 +71,21 @@ public function getChildNodes(): DomNodeIterator
         return $this->childNodes;
     }
 
-    public function setParentNode(DomElementInterface $node = null): ?DomElementInterface
+    public function setParentNode(DomElementInterface $node = null): DomElementInterface
     {
         $this->parentNode = $node;
 
         return $this;
     }
 
-    public function setPrevSibling(DomElementInterface $node = null): ?DomElementInterface
+    public function setPrevSibling(DomElementInterface $node = null): DomElementInterface
     {
         $this->prevSibling = $node;
 
         return $this;
     }
 
-    public function setNextSibling(DomElementInterface $node = null): ?DomElementInterface
+    public function setNextSibling(DomElementInterface $node = null): DomElementInterface
     {
         $this->nextSibling = $node;
 
@@ -205,10 +205,14 @@ public function after(DomElementInterface $node): DomElementInterface
 
     public function detach(): DomElementInterface
     {
+        $parent = $this->getParentNode();
         $prev = $this->getPrevSibling();
         $next = $this->getNextSibling();
         $prev && $prev->setNextSibling($next);
         $next && $next->setPrevSibling($prev);
+        if ($parent && $parent->getChildNodes()->head === $this) {
+            $parent->getChildNodes()->head = $next;
+        }
         $this->setParentNode(null);
         $this->setPrevSibling(null);
         $this->setNextSibling(null);