minor #15845 [DomCrawler] Document innerText() method (javiereguiluz)

javiereguiluz · javiereguiluz · commit b3fdbee41a6c · 2021-09-24T20:01:24.000+02:00
This PR was merged into the 5.4 branch. Discussion ---------- [DomCrawler] Document innerText() method Fixes #15836. Commits ------- cc062a9 [DomCrawler] Document innerText() method
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
@@ -230,6 +230,16 @@ Access the value of the first node of the current selection::
     // pass FALSE as the second argument to return the original text unchanged
     $crawler->filterXPath('//body/p')->text('Default text content', false);
 
+    // innerText() is similar to text() but returns only the text that is
+    // the direct descendent of the current node, excluding any child nodes
+    $text = $crawler->filterXPath('//body/p')->innerText();
+    // if content is <p>Foo <span>Bar</span></p>
+    // innerText() returns 'Foo' and text() returns 'Foo Bar'
+
+.. versionadded:: 5.4
+
+    The ``innerText()`` method was introduced in Symfony 5.4.
+
 Access the attribute value of the first node of the current selection::
 
     $class = $crawler->filterXPath('//body/p')->attr('class');
