Method text

pyquery/pyquery.py:1157–1199

Get or set the text representation of sub nodes. Get the text value:: >>> doc = PyQuery(' toto tata ') >>> print(doc.text()) tototata >>> doc = PyQuery(''' toto ...

(self, value=no_default, **kwargs)

        return etree.tostring(e0, encoding=str, method=method)

    def text(self, value=no_default, **kwargs):
        """Get or set the text representation of sub nodes.

        Get the text value::

            >>> doc = PyQuery('<div><span>toto</span><span>tata</span></div>')
            >>> print(doc.text())
            tototata
            >>> doc = PyQuery(''&#x27;<div><span>toto</span>
            ...               <span>tata</span></div>''&#x27;)
            >>> print(doc.text())
            toto tata

        Get the text value, without squashing newlines::

            >>> doc = PyQuery(''&#x27;<div><span>toto</span>
            ...               <span>tata</span></div>''&#x27;)
            >>> print(doc.text(squash_space=False))
            toto
            tata

        Set the text value::

            >>> doc.text('Youhou !')
            [<div>]
            >>> print(doc)
            <div>Youhou !</div>

        """

        if value is no_default:
            if not self:
                return ''
            return ' '.join(
                self._copy(tag).html() if tag.tag == 'textarea' else
                extract_text(tag, **kwargs) for tag in self
            )

        for tag in self:
            for child in tag.getchildren():
                tag.remove(child)
            tag.text = value
        return self

    ################
    # Manipulating #