Merge pull request #3 from staabm/patch-1

Added new Element->appendTextNode() API

Author: dantleech

lib/Element.php

@@ -19,9 +19,32 @@
  */
 class Element extends \DOMElement implements XPathAware
 {
+    /**
+     * Create and append a text-node with the given name and value.
+     *
+     * @param string $name
+     * @param string $value
+     *
+     * @return Element
+     */
+    public function appendTextNode($name, $value)
+    {
+        $el = new self($name);
+        $element = $this->appendChild($el);
+        assert($element instanceof Element);
+        
+        $element->appendChild(
+            $this->owner()->createTextNode($value)
+        );
+
+        return $element;
+    }
+    
     /**
      * Create and append an element with the given name and optionally given value.
      *
+     * Note: The value will not be escaped. Use DOMDocument::createTextNode() to create a text node with escaping support.
+     *
      * @param string $name
      * @param mixed  $value
      *

tests/Unit/ElementTest.php

@@ -35,6 +35,17 @@ public function testAppendElement(): void
         $this->assertInstanceOf('PhpBench\Dom\Element', $element);
         $this->assertEquals(1, $result);
     }
+    
+    /**
+     * It should create and append text.
+     */
+    public function testAppendTextNode(): void
+    {
+        $element = $this->element->appendTextNode('hello', 'fix&foxy');
+        $result = $this->document->evaluate('count(//hello)');
+        $this->assertInstanceOf('PhpBench\Dom\Element', $element);
+        $this->assertEquals(1, $result);
+    }
 
     /**
      * It should exeucte an XPath query.