From c28854b7ef38cce8d7f9ee9db04f478362b9f019 Mon Sep 17 00:00:00 2001 From: laminas-bot Date: Thu, 5 Dec 2024 15:14:06 +0000 Subject: [PATCH] Automated deployment: Thu Dec 5 15:14:06 UTC 2024 2.14.1 --- index.html | 76 ++++++++++++++++++++++++++++++++------- intro/index.html | 55 ++++++++++++++++++++++------ pages/404.html | 45 ++++++++++++++++++----- query/index.html | 55 ++++++++++++++++++++++------ search/search_index.json | 2 +- sitemap.xml | 6 ++-- sitemap.xml.gz | Bin 208 -> 209 bytes 7 files changed, 193 insertions(+), 46 deletions(-) diff --git a/index.html b/index.html index 05b3074..9653318 100644 --- a/index.html +++ b/index.html @@ -5,18 +5,18 @@ - + - + - laminas-dom - Laminas Docs + laminas-dom (Abandoned) - Laminas Docs @@ -111,7 +111,16 @@

- laminas-dom + + + + laminas-dom + + + abandoned + + +

Table of Contents
@@ -178,7 +187,16 @@

Components - laminas-dom + + + + laminas-dom + + + abandoned + + +

@@ -191,7 +209,7 @@

Search - + GitHub @@ -215,7 +233,13 @@

  • Components
    • -
  • laminas-dom
    • +
  • + + laminas-dom + + + +
    • @@ -225,8 +249,25 @@

    -

    laminas-dom

    -

    laminas-dom

    +

    + + + laminas-dom + + + abandoned + + +

    +

    Provides tools for working with DOM documents and structures

    + + + +
    +

    Caution

    +

    This package is abandoned and will receive no further development.

    +
    +

    Installation

    @@ -291,7 +332,16 @@
    Find documentation…

    - laminas-dom + + + + laminas-dom + + + abandoned + + +

    Table of Contents
    @@ -414,7 +464,7 @@

    Copyright

    @@ -435,7 +485,7 @@
    Search
    - +
    @@ -450,5 +500,5 @@
    Search
    diff --git a/intro/index.html b/intro/index.html index 4eba3f3..bf4390a 100644 --- a/intro/index.html +++ b/intro/index.html @@ -5,18 +5,18 @@ - + - + - Intro - laminas-dom - Laminas Docs + Intro - laminas-dom (Abandoned) - Laminas Docs @@ -111,7 +111,16 @@

    - laminas-dom + + + + laminas-dom + + + abandoned + + +

    Table of Contents
    @@ -178,7 +187,16 @@

    Components - laminas-dom + + + + laminas-dom + + + abandoned + + +

    @@ -191,7 +209,7 @@

    Search - + GitHub @@ -222,7 +240,15 @@

  • Components
    • -
  • laminas-dom
    • +
  • + + + laminas-dom + + + + +
    • @@ -300,7 +326,16 @@

    Find documentation…

    - laminas-dom + + + + laminas-dom + + + abandoned + + +

    Table of Contents
    @@ -423,7 +458,7 @@

    Copyright

    @@ -444,7 +479,7 @@
    Search
    - +
    diff --git a/pages/404.html b/pages/404.html index b8f3394..4b3755c 100644 --- a/pages/404.html +++ b/pages/404.html @@ -5,18 +5,18 @@ - + - + - laminas-dom - Laminas Docs + laminas-dom (Abandoned) - Laminas Docs @@ -111,7 +111,16 @@

    - laminas-dom + + + + laminas-dom + + + abandoned + + +

    Table of Contents
    @@ -178,7 +187,16 @@

    Components - laminas-dom + + + + laminas-dom + + + abandoned + + +

    @@ -191,7 +209,7 @@

    Search - + GitHub @@ -244,7 +262,16 @@

    Find documentation…

    - laminas-dom + + + + laminas-dom + + + abandoned + + +

    Table of Contents
    @@ -367,7 +394,7 @@

    Copyright

    @@ -388,7 +415,7 @@
    Search
    - +
    diff --git a/query/index.html b/query/index.html index 15346cd..a62cb9e 100644 --- a/query/index.html +++ b/query/index.html @@ -5,18 +5,18 @@ - + - + - Querying HTML and XML - laminas-dom - Laminas Docs + Querying HTML and XML - laminas-dom (Abandoned) - Laminas Docs @@ -111,7 +111,16 @@

    - laminas-dom + + + + laminas-dom + + + abandoned + + +

    Table of Contents
    @@ -178,7 +187,16 @@

    Components - laminas-dom + + + + laminas-dom + + + abandoned + + +

    @@ -191,7 +209,7 @@

    Search - + GitHub @@ -237,7 +255,15 @@

    On this page
  • Components
    • -
  • laminas-dom
    • +
  • + + + laminas-dom + + + + +
    • @@ -426,7 +452,16 @@
    Find documentation…

    - laminas-dom + + + + laminas-dom + + + abandoned + + +

    Table of Contents
    @@ -549,7 +584,7 @@

    Copyright

    @@ -570,7 +605,7 @@
    Search
    - +
    diff --git a/search/search_index.json b/search/search_index.json index 99472d6..8a0c01a 100644 --- a/search/search_index.json +++ b/search/search_index.json @@ -1 +1 @@ -{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"laminas-dom 🇷🇺 Русским гражданам Мы, участники Laminas, родились и живем в разных странах. У многих из нас есть друзья, родственники и коллеги как в России, так и в Украине. Некоторые из нас родились в России. Некоторые из нас живут в России. У некоторых бабушки и дедушки сражались с фашистами во Второй мировой войне. Здесь никто не поддерживает фашизм. У одного из нас есть украинская родственница, которая спаслась из дома вместе с сыном. Поезд задержался из-за бомбежки на дороге впереди. У нас есть друзья, которые прячутся в бомбоубежищах. Мы с тревогой ждем весточки от них после воздушных налетов, которые беспорядочно наносят удары и попадают по больницам, школам, детским садам и домам. Мы не берем это из каких-либо СМИ. Мы наблюдаем это напрямую. Вы доверяете нам достаточно, чтоб использовать наши программы, и мы просим вас довериться нам вновь. Мы нуждаемся в помощи. Выходите и протестуйте против этой бесполезной войны. Остановите кровопролитие. Скажите \"Нет войне!\" 🇺🇸 To Citizens of Russia We at Laminas come from all over the world. Many of us have friends, family and colleagues in both Russia and Ukraine. Some of us were born in Russia. Some of us currently live in Russia. Some have grandparents who fought Nazis in World War II. Nobody here supports fascism. One team member has a Ukrainian relative who fled her home with her son. The train was delayed due to bombing on the road ahead. We have friends who are hiding in bomb shelters. We anxiously follow up on them after the air raids, which indiscriminately fire at hospitals, schools, kindergartens and houses. We're not taking this from any media. These are our actual experiences. You trust us enough to use our software. We ask that you trust us to say the truth on this. We need your help. Go out and protest this unnecessary war. Stop the bloodshed. Say \"stop the war!\" This package is considered feature-complete, and is now in security-only maintenance mode, following a decision by the Technical Steering Committee . If you have a security issue, please follow our security reporting guidelines . If you wish to take on the role of maintainer, please nominate yourself If you are looking for an actively maintained package alternative, we recommend: symfony/dom-crawler The Laminas\\Dom component provides tools for working with DOM documents and structures. Currently, we offer Laminas\\Dom\\Query , which provides a unified interface for querying DOM documents utilizing both XPath and CSS selectors. File issues at https://github.com/laminas/laminas-dom/issues Documentation is at https://docs.laminas.dev/laminas-dom","title":"Home"},{"location":"#laminas-dom","text":"","title":"laminas-dom"},{"location":"#_1","text":"Мы, участники Laminas, родились и живем в разных странах. У многих из нас есть друзья, родственники и коллеги как в России, так и в Украине. Некоторые из нас родились в России. Некоторые из нас живут в России. У некоторых бабушки и дедушки сражались с фашистами во Второй мировой войне. Здесь никто не поддерживает фашизм. У одного из нас есть украинская родственница, которая спаслась из дома вместе с сыном. Поезд задержался из-за бомбежки на дороге впереди. У нас есть друзья, которые прячутся в бомбоубежищах. Мы с тревогой ждем весточки от них после воздушных налетов, которые беспорядочно наносят удары и попадают по больницам, школам, детским садам и домам. Мы не берем это из каких-либо СМИ. Мы наблюдаем это напрямую. Вы доверяете нам достаточно, чтоб использовать наши программы, и мы просим вас довериться нам вновь. Мы нуждаемся в помощи. Выходите и протестуйте против этой бесполезной войны. Остановите кровопролитие. Скажите \"Нет войне!\"","title":"🇷🇺 Русским гражданам"},{"location":"#to-citizens-of-russia","text":"We at Laminas come from all over the world. Many of us have friends, family and colleagues in both Russia and Ukraine. Some of us were born in Russia. Some of us currently live in Russia. Some have grandparents who fought Nazis in World War II. Nobody here supports fascism. One team member has a Ukrainian relative who fled her home with her son. The train was delayed due to bombing on the road ahead. We have friends who are hiding in bomb shelters. We anxiously follow up on them after the air raids, which indiscriminately fire at hospitals, schools, kindergartens and houses. We're not taking this from any media. These are our actual experiences. You trust us enough to use our software. We ask that you trust us to say the truth on this. We need your help. Go out and protest this unnecessary war. Stop the bloodshed. Say \"stop the war!\" This package is considered feature-complete, and is now in security-only maintenance mode, following a decision by the Technical Steering Committee . If you have a security issue, please follow our security reporting guidelines . If you wish to take on the role of maintainer, please nominate yourself If you are looking for an actively maintained package alternative, we recommend: symfony/dom-crawler The Laminas\\Dom component provides tools for working with DOM documents and structures. Currently, we offer Laminas\\Dom\\Query , which provides a unified interface for querying DOM documents utilizing both XPath and CSS selectors. File issues at https://github.com/laminas/laminas-dom/issues Documentation is at https://docs.laminas.dev/laminas-dom","title":"🇺🇸 To Citizens of Russia"},{"location":"intro/","text":"Introduction laminas-dom provides tools for working with DOM documents and structures. Currently, we offer Laminas\\Dom\\Query , which provides a unified interface for querying DOM documents utilizing both XPath and CSS selectors.","title":"Intro"},{"location":"intro/#introduction","text":"laminas-dom provides tools for working with DOM documents and structures. Currently, we offer Laminas\\Dom\\Query , which provides a unified interface for querying DOM documents utilizing both XPath and CSS selectors.","title":"Introduction"},{"location":"query/","text":"Querying HTML and XML Documents Laminas\\Dom\\Query provides mechanisms for querying XML and HTML documents utilizing either XPath or CSS selectors. It was developed to aid with functional testing of MVC applications, but could also be used for development of screen scrapers. CSS selector notation is provided as a simpler and more familiar notation for web developers to utilize when querying documents with XML structures. The notation should be familiar to anybody who has developed Cascading Style Sheets or who utilizes javascript toolkits that provide functionality for selecting nodes utilizing CSS selectors. Prototype's $$() , Dojo's dojo.query , and jQuery were all inspirations for the component. Theory of Operation To use Laminas\\Dom\\Query , you instantiate a Laminas\\Dom\\Query object, optionally passing a document to query (a string). Once you have a document, you can use either the execute() or queryXpath() methods; each method will return a Laminas\\Dom\\NodeList object with any matching nodes. The primary difference between Laminas\\Dom\\Query and using DOMDocument + DOMXPath is the ability to select against CSS + selectors. You can utilize any of the following, in any combination: element types : provide an element type to match: div , a , span , h2 , etc. style attributes : CSS style attributes to match: .error , div.error , label.required , etc. If an element defines more than one style, this will match as long as the named style is present anywhere in the style declaration. id attributes : element ID attributes to match: #content , div#nav , etc. arbitrary attributes : arbitrary element attributes to match. Three different types of matching are provided: exact match : the attribute exactly matches the specified string. div[bar=\"baz\"] would match a div element with a bar attribute that exactly matches the value baz . word match : the attribute contains a word matching the string. div[bar~=\"baz\"] would match a div element with a bar attribute that contains the word baz . <div bar=\"foo baz\"> would match, but <div bar=\"foo bazbat\"> would not. substring match : the attribute contains the string specified, whether or not it is a complete word. div[bar*=\"baz\"] would match a div element with a bar attribute that contains the string baz anywhere within it. direct descendents : utilize > between selectors to denote direct descendents. div > span would select only span elements that are direct descendents of a div . Can also be used with any of the selectors above. descendents : string together multiple selectors to indicate a hierarchy along which to search. div .foo span #one would select an element of id one that is a descendent of arbitrary depth beneath a span element, which is in turn a descendent of arbitrary depth beneath an element with a class of foo , that is an descendent of arbitrary depth beneath a div element. For example, it would match the link to the word 'One' in the listing below: <div> <table> <tr> <td class=\"foo\"> <div> Lorem ipsum <span class=\"bar\"> <a href=\"/foo/bar\" id=\"one\">One</a> <a href=\"/foo/baz\" id=\"two\">Two</a> <a href=\"/foo/bat\" id=\"three\">Three</a> <a href=\"/foo/bla\" id=\"four\">Four</a> </span> </div> </td> </tr> </table> </div> Once you've performed your query, you can then work with the result object to determine information about the nodes, as well as to pull them and/or their content directly for examination and manipulation. Laminas\\Dom\\NodeList implements Countable and Iterator , and stores the results internally as a DOMDocument and DOMNodeList . As an example, consider the following call, that selects against the HTML above: use Laminas\\Dom\\Query; $dom = new Query($html); $results = $dom->execute('.foo .bar a'); $count = count($results); // get number of matches: 4 foreach ($results as $result) { // $result is a DOMElement } Laminas\\Dom\\Query also allows straight XPath queries utilizing the queryXpath() method; you can pass any valid XPath query to this method, and it will return a Laminas\\Dom\\NodeList object. Methods Available Below is a listing of methods available in the various classes exposed by laminas-dom. Laminas\\Dom\\Query The following methods are available to Laminas\\Dom\\Query : setDocumentXml($document, $encoding = null) : specify an XML string to query against. setDocumentXhtml($document, $encoding = null) : specify an XHTML string to query against. setDocumentHtml($document, $encoding = null) : specify an HTML string to query against. setDocument($document, $encoding = null) : specify a string to query against; Laminas\\Dom\\Query will then attempt to autodetect the document type. setEncoding($encoding) : specify an encoding string to use. This encoding will be passed to DOMDocument's constructor if specified. getDocument() : retrieve the original document string provided to the object. getDocumentType() : retrieve the document type of the document provided to the object; will be one of the DOC_XML , DOC_XHTML , or DOC_HTML class constants. getEncoding() : retrieves the specified encoding. execute($query) : query the document using CSS selector notation. queryXpath($xPathQuery) : query the document using XPath notation. Laminas\\Dom\\NodeList As mentioned previously, Laminas\\Dom\\NodeList implements both Iterator and Countable , and as such can be used in a foreach() loop as well as with the count() function. Additionally, it exposes the following methods: getCssQuery() : return the CSS selector query used to produce the result (if any). getXpathQuery() : return the XPath query used to produce the result. Internally, Laminas\\Dom\\Query converts CSS selector queries to XPath, so this value will always be populated. getDocument() : retrieve the DOMDocument the selection was made against.","title":"Querying HTML and XML"},{"location":"query/#querying-html-and-xml-documents","text":"Laminas\\Dom\\Query provides mechanisms for querying XML and HTML documents utilizing either XPath or CSS selectors. It was developed to aid with functional testing of MVC applications, but could also be used for development of screen scrapers. CSS selector notation is provided as a simpler and more familiar notation for web developers to utilize when querying documents with XML structures. The notation should be familiar to anybody who has developed Cascading Style Sheets or who utilizes javascript toolkits that provide functionality for selecting nodes utilizing CSS selectors. Prototype's $$() , Dojo's dojo.query , and jQuery were all inspirations for the component.","title":"Querying HTML and XML Documents"},{"location":"query/#theory-of-operation","text":"To use Laminas\\Dom\\Query , you instantiate a Laminas\\Dom\\Query object, optionally passing a document to query (a string). Once you have a document, you can use either the execute() or queryXpath() methods; each method will return a Laminas\\Dom\\NodeList object with any matching nodes. The primary difference between Laminas\\Dom\\Query and using DOMDocument + DOMXPath is the ability to select against CSS + selectors. You can utilize any of the following, in any combination: element types : provide an element type to match: div , a , span , h2 , etc. style attributes : CSS style attributes to match: .error , div.error , label.required , etc. If an element defines more than one style, this will match as long as the named style is present anywhere in the style declaration. id attributes : element ID attributes to match: #content , div#nav , etc. arbitrary attributes : arbitrary element attributes to match. Three different types of matching are provided: exact match : the attribute exactly matches the specified string. div[bar=\"baz\"] would match a div element with a bar attribute that exactly matches the value baz . word match : the attribute contains a word matching the string. div[bar~=\"baz\"] would match a div element with a bar attribute that contains the word baz . <div bar=\"foo baz\"> would match, but <div bar=\"foo bazbat\"> would not. substring match : the attribute contains the string specified, whether or not it is a complete word. div[bar*=\"baz\"] would match a div element with a bar attribute that contains the string baz anywhere within it. direct descendents : utilize > between selectors to denote direct descendents. div > span would select only span elements that are direct descendents of a div . Can also be used with any of the selectors above. descendents : string together multiple selectors to indicate a hierarchy along which to search. div .foo span #one would select an element of id one that is a descendent of arbitrary depth beneath a span element, which is in turn a descendent of arbitrary depth beneath an element with a class of foo , that is an descendent of arbitrary depth beneath a div element. For example, it would match the link to the word 'One' in the listing below: <div> <table> <tr> <td class=\"foo\"> <div> Lorem ipsum <span class=\"bar\"> <a href=\"/foo/bar\" id=\"one\">One</a> <a href=\"/foo/baz\" id=\"two\">Two</a> <a href=\"/foo/bat\" id=\"three\">Three</a> <a href=\"/foo/bla\" id=\"four\">Four</a> </span> </div> </td> </tr> </table> </div> Once you've performed your query, you can then work with the result object to determine information about the nodes, as well as to pull them and/or their content directly for examination and manipulation. Laminas\\Dom\\NodeList implements Countable and Iterator , and stores the results internally as a DOMDocument and DOMNodeList . As an example, consider the following call, that selects against the HTML above: use Laminas\\Dom\\Query; $dom = new Query($html); $results = $dom->execute('.foo .bar a'); $count = count($results); // get number of matches: 4 foreach ($results as $result) { // $result is a DOMElement } Laminas\\Dom\\Query also allows straight XPath queries utilizing the queryXpath() method; you can pass any valid XPath query to this method, and it will return a Laminas\\Dom\\NodeList object.","title":"Theory of Operation"},{"location":"query/#methods-available","text":"Below is a listing of methods available in the various classes exposed by laminas-dom.","title":"Methods Available"}]} \ No newline at end of file +{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"laminas-dom [!CAUTION] This package is abandoned and will receive no further development. See the Technical Steering Committee meeting minutes . If you are looking for an actively maintained package alternative, we recommend: symfony/dom-crawler 🇷🇺 Русским гражданам Мы, участники Laminas, родились и живем в разных странах. У многих из нас есть друзья, родственники и коллеги как в России, так и в Украине. Некоторые из нас родились в России. Некоторые из нас живут в России. У некоторых бабушки и дедушки сражались с фашистами во Второй мировой войне. Здесь никто не поддерживает фашизм. У одного из нас есть украинская родственница, которая спаслась из дома вместе с сыном. Поезд задержался из-за бомбежки на дороге впереди. У нас есть друзья, которые прячутся в бомбоубежищах. Мы с тревогой ждем весточки от них после воздушных налетов, которые беспорядочно наносят удары и попадают по больницам, школам, детским садам и домам. Мы не берем это из каких-либо СМИ. Мы наблюдаем это напрямую. Вы доверяете нам достаточно, чтоб использовать наши программы, и мы просим вас довериться нам вновь. Мы нуждаемся в помощи. Выходите и протестуйте против этой бесполезной войны. Остановите кровопролитие. Скажите \"Нет войне!\" 🇺🇸 To Citizens of Russia We at Laminas come from all over the world. Many of us have friends, family and colleagues in both Russia and Ukraine. Some of us were born in Russia. Some of us currently live in Russia. Some have grandparents who fought Nazis in World War II. Nobody here supports fascism. One team member has a Ukrainian relative who fled her home with her son. The train was delayed due to bombing on the road ahead. We have friends who are hiding in bomb shelters. We anxiously follow up on them after the air raids, which indiscriminately fire at hospitals, schools, kindergartens and houses. We're not taking this from any media. These are our actual experiences. You trust us enough to use our software. We ask that you trust us to say the truth on this. We need your help. Go out and protest this unnecessary war. Stop the bloodshed. Say \"stop the war!\" The Laminas\\Dom component provides tools for working with DOM documents and structures. Currently, we offer Laminas\\Dom\\Query , which provides a unified interface for querying DOM documents utilizing both XPath and CSS selectors. Documentation is at https://docs.laminas.dev/laminas-dom","title":"Home"},{"location":"#laminas-dom","text":"[!CAUTION] This package is abandoned and will receive no further development. See the Technical Steering Committee meeting minutes . If you are looking for an actively maintained package alternative, we recommend: symfony/dom-crawler","title":"laminas-dom"},{"location":"#_1","text":"Мы, участники Laminas, родились и живем в разных странах. У многих из нас есть друзья, родственники и коллеги как в России, так и в Украине. Некоторые из нас родились в России. Некоторые из нас живут в России. У некоторых бабушки и дедушки сражались с фашистами во Второй мировой войне. Здесь никто не поддерживает фашизм. У одного из нас есть украинская родственница, которая спаслась из дома вместе с сыном. Поезд задержался из-за бомбежки на дороге впереди. У нас есть друзья, которые прячутся в бомбоубежищах. Мы с тревогой ждем весточки от них после воздушных налетов, которые беспорядочно наносят удары и попадают по больницам, школам, детским садам и домам. Мы не берем это из каких-либо СМИ. Мы наблюдаем это напрямую. Вы доверяете нам достаточно, чтоб использовать наши программы, и мы просим вас довериться нам вновь. Мы нуждаемся в помощи. Выходите и протестуйте против этой бесполезной войны. Остановите кровопролитие. Скажите \"Нет войне!\"","title":"🇷🇺 Русским гражданам"},{"location":"#to-citizens-of-russia","text":"We at Laminas come from all over the world. Many of us have friends, family and colleagues in both Russia and Ukraine. Some of us were born in Russia. Some of us currently live in Russia. Some have grandparents who fought Nazis in World War II. Nobody here supports fascism. One team member has a Ukrainian relative who fled her home with her son. The train was delayed due to bombing on the road ahead. We have friends who are hiding in bomb shelters. We anxiously follow up on them after the air raids, which indiscriminately fire at hospitals, schools, kindergartens and houses. We're not taking this from any media. These are our actual experiences. You trust us enough to use our software. We ask that you trust us to say the truth on this. We need your help. Go out and protest this unnecessary war. Stop the bloodshed. Say \"stop the war!\" The Laminas\\Dom component provides tools for working with DOM documents and structures. Currently, we offer Laminas\\Dom\\Query , which provides a unified interface for querying DOM documents utilizing both XPath and CSS selectors. Documentation is at https://docs.laminas.dev/laminas-dom","title":"🇺🇸 To Citizens of Russia"},{"location":"intro/","text":"Introduction laminas-dom provides tools for working with DOM documents and structures. Currently, we offer Laminas\\Dom\\Query , which provides a unified interface for querying DOM documents utilizing both XPath and CSS selectors.","title":"Intro"},{"location":"intro/#introduction","text":"laminas-dom provides tools for working with DOM documents and structures. Currently, we offer Laminas\\Dom\\Query , which provides a unified interface for querying DOM documents utilizing both XPath and CSS selectors.","title":"Introduction"},{"location":"query/","text":"Querying HTML and XML Documents Laminas\\Dom\\Query provides mechanisms for querying XML and HTML documents utilizing either XPath or CSS selectors. It was developed to aid with functional testing of MVC applications, but could also be used for development of screen scrapers. CSS selector notation is provided as a simpler and more familiar notation for web developers to utilize when querying documents with XML structures. The notation should be familiar to anybody who has developed Cascading Style Sheets or who utilizes javascript toolkits that provide functionality for selecting nodes utilizing CSS selectors. Prototype's $$() , Dojo's dojo.query , and jQuery were all inspirations for the component. Theory of Operation To use Laminas\\Dom\\Query , you instantiate a Laminas\\Dom\\Query object, optionally passing a document to query (a string). Once you have a document, you can use either the execute() or queryXpath() methods; each method will return a Laminas\\Dom\\NodeList object with any matching nodes. The primary difference between Laminas\\Dom\\Query and using DOMDocument + DOMXPath is the ability to select against CSS + selectors. You can utilize any of the following, in any combination: element types : provide an element type to match: div , a , span , h2 , etc. style attributes : CSS style attributes to match: .error , div.error , label.required , etc. If an element defines more than one style, this will match as long as the named style is present anywhere in the style declaration. id attributes : element ID attributes to match: #content , div#nav , etc. arbitrary attributes : arbitrary element attributes to match. Three different types of matching are provided: exact match : the attribute exactly matches the specified string. div[bar=\"baz\"] would match a div element with a bar attribute that exactly matches the value baz . word match : the attribute contains a word matching the string. div[bar~=\"baz\"] would match a div element with a bar attribute that contains the word baz . <div bar=\"foo baz\"> would match, but <div bar=\"foo bazbat\"> would not. substring match : the attribute contains the string specified, whether or not it is a complete word. div[bar*=\"baz\"] would match a div element with a bar attribute that contains the string baz anywhere within it. direct descendents : utilize > between selectors to denote direct descendents. div > span would select only span elements that are direct descendents of a div . Can also be used with any of the selectors above. descendents : string together multiple selectors to indicate a hierarchy along which to search. div .foo span #one would select an element of id one that is a descendent of arbitrary depth beneath a span element, which is in turn a descendent of arbitrary depth beneath an element with a class of foo , that is an descendent of arbitrary depth beneath a div element. For example, it would match the link to the word 'One' in the listing below: <div> <table> <tr> <td class=\"foo\"> <div> Lorem ipsum <span class=\"bar\"> <a href=\"/foo/bar\" id=\"one\">One</a> <a href=\"/foo/baz\" id=\"two\">Two</a> <a href=\"/foo/bat\" id=\"three\">Three</a> <a href=\"/foo/bla\" id=\"four\">Four</a> </span> </div> </td> </tr> </table> </div> Once you've performed your query, you can then work with the result object to determine information about the nodes, as well as to pull them and/or their content directly for examination and manipulation. Laminas\\Dom\\NodeList implements Countable and Iterator , and stores the results internally as a DOMDocument and DOMNodeList . As an example, consider the following call, that selects against the HTML above: use Laminas\\Dom\\Query; $dom = new Query($html); $results = $dom->execute('.foo .bar a'); $count = count($results); // get number of matches: 4 foreach ($results as $result) { // $result is a DOMElement } Laminas\\Dom\\Query also allows straight XPath queries utilizing the queryXpath() method; you can pass any valid XPath query to this method, and it will return a Laminas\\Dom\\NodeList object. Methods Available Below is a listing of methods available in the various classes exposed by laminas-dom. Laminas\\Dom\\Query The following methods are available to Laminas\\Dom\\Query : setDocumentXml($document, $encoding = null) : specify an XML string to query against. setDocumentXhtml($document, $encoding = null) : specify an XHTML string to query against. setDocumentHtml($document, $encoding = null) : specify an HTML string to query against. setDocument($document, $encoding = null) : specify a string to query against; Laminas\\Dom\\Query will then attempt to autodetect the document type. setEncoding($encoding) : specify an encoding string to use. This encoding will be passed to DOMDocument's constructor if specified. getDocument() : retrieve the original document string provided to the object. getDocumentType() : retrieve the document type of the document provided to the object; will be one of the DOC_XML , DOC_XHTML , or DOC_HTML class constants. getEncoding() : retrieves the specified encoding. execute($query) : query the document using CSS selector notation. queryXpath($xPathQuery) : query the document using XPath notation. Laminas\\Dom\\NodeList As mentioned previously, Laminas\\Dom\\NodeList implements both Iterator and Countable , and as such can be used in a foreach() loop as well as with the count() function. Additionally, it exposes the following methods: getCssQuery() : return the CSS selector query used to produce the result (if any). getXpathQuery() : return the XPath query used to produce the result. Internally, Laminas\\Dom\\Query converts CSS selector queries to XPath, so this value will always be populated. getDocument() : retrieve the DOMDocument the selection was made against.","title":"Querying HTML and XML"},{"location":"query/#querying-html-and-xml-documents","text":"Laminas\\Dom\\Query provides mechanisms for querying XML and HTML documents utilizing either XPath or CSS selectors. It was developed to aid with functional testing of MVC applications, but could also be used for development of screen scrapers. CSS selector notation is provided as a simpler and more familiar notation for web developers to utilize when querying documents with XML structures. The notation should be familiar to anybody who has developed Cascading Style Sheets or who utilizes javascript toolkits that provide functionality for selecting nodes utilizing CSS selectors. Prototype's $$() , Dojo's dojo.query , and jQuery were all inspirations for the component.","title":"Querying HTML and XML Documents"},{"location":"query/#theory-of-operation","text":"To use Laminas\\Dom\\Query , you instantiate a Laminas\\Dom\\Query object, optionally passing a document to query (a string). Once you have a document, you can use either the execute() or queryXpath() methods; each method will return a Laminas\\Dom\\NodeList object with any matching nodes. The primary difference between Laminas\\Dom\\Query and using DOMDocument + DOMXPath is the ability to select against CSS + selectors. You can utilize any of the following, in any combination: element types : provide an element type to match: div , a , span , h2 , etc. style attributes : CSS style attributes to match: .error , div.error , label.required , etc. If an element defines more than one style, this will match as long as the named style is present anywhere in the style declaration. id attributes : element ID attributes to match: #content , div#nav , etc. arbitrary attributes : arbitrary element attributes to match. Three different types of matching are provided: exact match : the attribute exactly matches the specified string. div[bar=\"baz\"] would match a div element with a bar attribute that exactly matches the value baz . word match : the attribute contains a word matching the string. div[bar~=\"baz\"] would match a div element with a bar attribute that contains the word baz . <div bar=\"foo baz\"> would match, but <div bar=\"foo bazbat\"> would not. substring match : the attribute contains the string specified, whether or not it is a complete word. div[bar*=\"baz\"] would match a div element with a bar attribute that contains the string baz anywhere within it. direct descendents : utilize > between selectors to denote direct descendents. div > span would select only span elements that are direct descendents of a div . Can also be used with any of the selectors above. descendents : string together multiple selectors to indicate a hierarchy along which to search. div .foo span #one would select an element of id one that is a descendent of arbitrary depth beneath a span element, which is in turn a descendent of arbitrary depth beneath an element with a class of foo , that is an descendent of arbitrary depth beneath a div element. For example, it would match the link to the word 'One' in the listing below: <div> <table> <tr> <td class=\"foo\"> <div> Lorem ipsum <span class=\"bar\"> <a href=\"/foo/bar\" id=\"one\">One</a> <a href=\"/foo/baz\" id=\"two\">Two</a> <a href=\"/foo/bat\" id=\"three\">Three</a> <a href=\"/foo/bla\" id=\"four\">Four</a> </span> </div> </td> </tr> </table> </div> Once you've performed your query, you can then work with the result object to determine information about the nodes, as well as to pull them and/or their content directly for examination and manipulation. Laminas\\Dom\\NodeList implements Countable and Iterator , and stores the results internally as a DOMDocument and DOMNodeList . As an example, consider the following call, that selects against the HTML above: use Laminas\\Dom\\Query; $dom = new Query($html); $results = $dom->execute('.foo .bar a'); $count = count($results); // get number of matches: 4 foreach ($results as $result) { // $result is a DOMElement } Laminas\\Dom\\Query also allows straight XPath queries utilizing the queryXpath() method; you can pass any valid XPath query to this method, and it will return a Laminas\\Dom\\NodeList object.","title":"Theory of Operation"},{"location":"query/#methods-available","text":"Below is a listing of methods available in the various classes exposed by laminas-dom.","title":"Methods Available"}]} \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml index a9c6e08..0c125f3 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2,14 +2,14 @@ https://docs.laminas.dev/laminas-dom/ - 2024-11-21 + 2024-12-05 https://docs.laminas.dev/laminas-dom/intro/ - 2024-11-21 + 2024-12-05 https://docs.laminas.dev/laminas-dom/query/ - 2024-11-21 + 2024-12-05 \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz index 03ff772fbb7f7ab601832e72d259ff0c2272668e..faaeca289267443f513da19ae341083a9f529065 100644 GIT binary patch literal 209 zcmV;?051O@iwFn+?NDa||8r?{Wo=<_E_iKh0L76_4uUWch4-F05AU^iwFn+cs^$W|8r?{Wo=<_E_iKh0L76#4udcZg?CPYvJ(U9&{hz(o}fKI zL?Vck9~uW}Z{P5vsxwQy*nWC`-{7iw8J$kjqjI(;1=xT}>YMTXrT5ORCXp zlp&2~i#6#(7_I>GJX2Ib8a^O(z5{IgxFGBz