diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst index c9809e28331..f0372bfeb25 100644 --- a/components/dom_crawler.rst +++ b/components/dom_crawler.rst @@ -48,9 +48,11 @@ traverse easily:: print $domElement->nodeName; } -Specialized :class:`Symfony\\Component\\DomCrawler\\Link` and +Specialized :class:`Symfony\\Component\\DomCrawler\\Link`, +:class:`Symfony\\Component\\DomCrawler\\Image` and :class:`Symfony\\Component\\DomCrawler\\Form` classes are useful for -interacting with html links and forms as you traverse through the HTML tree. +interacting with html links, images and forms as you traverse through the HTML +tree. .. note:: @@ -303,7 +305,7 @@ Links ~~~~~ To find a link by name (or a clickable image by its ``alt`` attribute), use -the ``selectLink`` method on an existing crawler. This returns a Crawler +the ``selectLink`` method on an existing crawler. This returns a ``Crawler`` instance with just the selected link(s). Calling ``link()`` gives you a special :class:`Symfony\\Component\\DomCrawler\\Link` object:: @@ -327,6 +329,23 @@ methods to get more information about the selected link itself:: page suffixed with ``#foo``. The return from ``getUri()`` is always a full URI that you can act on. +Images +~~~~~~ + +To find an image by its ``alt`` attribute, use the ``selectImage`` method on an +existing crawler. This returns a ``Crawler`` instance with just the selected +image(s). Calling ``image()`` gives you a special +:class:`Symfony\\Component\\DomCrawler\\Image` object:: + + $imagesCrawler = $crawler->selectImage('Kitten'); + $image = $imagesCrawler->image(); + + // or do this all at once + $image = $crawler->selectImage('Kitten')->image(); + +The :class:`Symfony\\Component\\DomCrawler\\Image` object has the same +``getUri()`` method as :class:`Symfony\\Component\\DomCrawler\\Link`. + Forms ~~~~~
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies: