$61

Implemented new setText method

Author: paquettg

README.md

@@ -12,7 +12,7 @@ PHPHtmlParser is a simple, flexible, html parser which allows you to select tags
 Install
 -------
 
-This package can be found on [packagist](https://packagist.org/packages/paquettg/php-html-parser) and is best loaded using [composer](http://getcomposer.org/). We support php 5.6, 7.0, and hhvm 2.3.
+This package can be found on [packagist](https://packagist.org/packages/paquettg/php-html-parser) and is best loaded using [composer](http://getcomposer.org/). We support php 5.6, 7.0, 7.1.
 
 Usage
 -----
@@ -217,3 +217,13 @@ $a->delete();
 unset($a);
 echo $dom; // '<div class="all"><p>Hey bro, <br /> :)</p></div>');
 ```
+
+You can modify the text of `TextNode` objects easely. Please note that, if you set an encoding, the new text will be encoded using the existing encoding.
+
+```php
+$dom = new Dom;
+$dom->load('<div class="all"><p>Hey bro, <a href="google.com">click here</a><br /> :)</p></div>');
+$a   = $dom->find('a')[0];
+$a->firstChild()->setText('biz baz');
+echo $dom; // '<div class="all"><p>Hey bro, <a href="google.com">biz baz</a><br /> :)</p></div>'
+```

src/PHPHtmlParser/Dom/TextNode.php

@@ -72,6 +72,24 @@ public function text()
         }
     }
 
+    /**
+     * Sets the text for this node.
+     *
+     * @var string $text
+     * @return void
+     */
+    public function setText($text)
+    {
+        $this->text = $text;
+
+        if ( ! is_null($this->encode)) {
+            $text = $this->encode->convert($text);
+
+            // remember the conversion
+            $this->convertedText = $text;
+        }
+    }
+
     /**
      * This node has no html, just return the text.
      *

tests/Node/TextTest.php

@@ -1,6 +1,8 @@
 <?php
 
+use PHPHtmlParser\Dom;
 use PHPHtmlParser\Dom\TextNode;
+use stringEncode\Encode;
 
 class NodeTextTest extends PHPUnit_Framework_TestCase {
 
@@ -29,4 +31,25 @@ public function testPreserveEntity()
         $text = $node->innerhtml;
         $this->assertEquals('&#x69;', $text);
     }
+
+    public function testSetText()
+    {
+        $dom = new Dom;
+        $dom->load('<div class="all"><p>Hey bro, <a href="google.com">click here</a><br /> :)</p></div>');
+        $a   = $dom->find('a')[0];
+        $a->firstChild()->setText('biz baz');
+        $this->assertEquals('<div class="all"><p>Hey bro, <a href="google.com">biz baz</a><br /> :)</p></div>', (string) $dom);
+    }
+
+    public function testSetTextEncoded()
+    {
+        $encode = new Encode;
+        $encode->from('UTF-8');
+        $encode->to('UTF-8');
+
+        $node = new TextNode('foo bar');
+        $node->propagateEncoding($encode);
+        $node->setText('biz baz');
+        $this->assertEquals('biz baz', $node->text());
+    }
 }