diff --git a/index.html b/index.html index 83668d2..d408e8a 100644 --- a/index.html +++ b/index.html @@ -403,7 +403,7 @@

Support

License

Code licensed under BSD 3-Clause. + href="https://github.com/laminas/laminas-dom/blob/-/LICENSE.md">BSD 3-Clause.

@@ -412,7 +412,7 @@

License

Copyright

+ contributors.
--> © 2022 Laminas Project a Series of LF Projects, LLC.

@@ -460,6 +460,6 @@
Search
diff --git a/intro/index.html b/intro/index.html index 4d8526c..d8c5d75 100644 --- a/intro/index.html +++ b/intro/index.html @@ -412,7 +412,7 @@

Support

License

Code licensed under BSD 3-Clause. + href="https://github.com/laminas/laminas-dom/blob/-/LICENSE.md">BSD 3-Clause.

@@ -421,7 +421,7 @@

License

Copyright

+ contributors.
--> © 2022 Laminas Project a Series of LF Projects, LLC.

diff --git a/pages/404.html b/pages/404.html index f13fb40..ad523ff 100644 --- a/pages/404.html +++ b/pages/404.html @@ -356,7 +356,7 @@

Support

License

Code licensed under BSD 3-Clause. + href="https://github.com/laminas/laminas-dom/blob/-/LICENSE.md">BSD 3-Clause.

@@ -365,7 +365,7 @@

License

Copyright

+ contributors.
--> © 2022 Laminas Project a Series of LF Projects, LLC.

diff --git a/query/index.html b/query/index.html index c2f6eba..6f1b936 100644 --- a/query/index.html +++ b/query/index.html @@ -538,7 +538,7 @@

Support

License

Code licensed under BSD 3-Clause. + href="https://github.com/laminas/laminas-dom/blob/-/LICENSE.md">BSD 3-Clause.

@@ -547,7 +547,7 @@

License

Copyright

+ contributors.
--> © 2022 Laminas Project a Series of LF Projects, LLC.

diff --git a/search/lunr.js b/search/lunr.js index 6aa370f..aca0a16 100644 --- a/search/lunr.js +++ b/search/lunr.js @@ -3456,7 +3456,7 @@ lunr.QueryParser.parseBoost = function (parser) { } else if (typeof exports === 'object') { /** * Node. Does not work with strict CommonJS, but - * only CommonJS-like enviroments that support module.exports, + * only CommonJS-like environments that support module.exports, * like Node. */ module.exports = factory() diff --git a/search/search_index.json b/search/search_index.json index 7ab9621..99472d6 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 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":"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":"laminas-dom"},{"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 πŸ‡·πŸ‡Ί Русским Π³Ρ€Π°ΠΆΠ΄Π°Π½Π°ΠΌ ΠœΡ‹, участники 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 diff --git a/sitemap.xml b/sitemap.xml index 1d03f6e..381a13d 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2,17 +2,17 @@ https://docs.laminas.dev/laminas-dom/ - 2022-06-27 + 2022-10-16 daily https://docs.laminas.dev/laminas-dom/intro/ - 2022-06-27 + 2022-10-16 daily https://docs.laminas.dev/laminas-dom/query/ - 2022-06-27 + 2022-10-16 daily \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz index b2765be..b18b332 100644 Binary files a/sitemap.xml.gz and b/sitemap.xml.gz differ