@@ -108,34 +108,34 @@ discard block |
||
| 108 | 108 | } |
| 109 | 109 | |
| 110 | 110 | /** |
| 111 | - * Evaluate and return the result of a given XPath expression using this element as context node |
|
| 112 | - * |
|
| 113 | - * @param string $expr XPath expression |
|
| 114 | - * @return mixed |
|
| 115 | - */ |
|
| 111 | + * Evaluate and return the result of a given XPath expression using this element as context node |
|
| 112 | + * |
|
| 113 | + * @param string $expr XPath expression |
|
| 114 | + * @return mixed |
|
| 115 | + */ |
|
| 116 | 116 | public function evaluate(string $expr) |
| 117 | 117 | { |
| 118 | 118 | return $this->ownerDocument->evaluate($expr, $this); |
| 119 | 119 | } |
| 120 | 120 | |
| 121 | 121 | /** |
| 122 | - * Evaluate and return the first element of a given XPath query using this element as context node |
|
| 123 | - * |
|
| 124 | - * @param string $expr XPath expression |
|
| 125 | - * @return DOMNode|null |
|
| 126 | - */ |
|
| 122 | + * Evaluate and return the first element of a given XPath query using this element as context node |
|
| 123 | + * |
|
| 124 | + * @param string $expr XPath expression |
|
| 125 | + * @return DOMNode|null |
|
| 126 | + */ |
|
| 127 | 127 | public function firstOf(string $expr): ?DOMNode |
| 128 | 128 | { |
| 129 | 129 | return $this->ownerDocument->firstOf($expr, $this); |
| 130 | 130 | } |
| 131 | 131 | |
| 132 | 132 | /** |
| 133 | - * Insert given element relative to this element's position |
|
| 134 | - * |
|
| 135 | - * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 136 | - * @param self $element |
|
| 137 | - * @return self |
|
| 138 | - */ |
|
| 133 | + * Insert given element relative to this element's position |
|
| 134 | + * |
|
| 135 | + * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 136 | + * @param self $element |
|
| 137 | + * @return self |
|
| 138 | + */ |
|
| 139 | 139 | public function insertAdjacentElement(string $where, self $element): self |
| 140 | 140 | { |
| 141 | 141 | $this->insertAdjacentNode($where, $element); |
@@ -144,24 +144,24 @@ discard block |
||
| 144 | 144 | } |
| 145 | 145 | |
| 146 | 146 | /** |
| 147 | - * Insert given text relative to this element's position |
|
| 148 | - * |
|
| 149 | - * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 150 | - * @param string $text |
|
| 151 | - * @return void |
|
| 152 | - */ |
|
| 147 | + * Insert given text relative to this element's position |
|
| 148 | + * |
|
| 149 | + * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 150 | + * @param string $text |
|
| 151 | + * @return void |
|
| 152 | + */ |
|
| 153 | 153 | public function insertAdjacentText(string $where, string $text): void |
| 154 | 154 | { |
| 155 | 155 | $this->insertText($where, $text); |
| 156 | 156 | } |
| 157 | 157 | |
| 158 | 158 | /** |
| 159 | - * Insert given XML relative to this element's position |
|
| 160 | - * |
|
| 161 | - * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 162 | - * @param string $xml |
|
| 163 | - * @return void |
|
| 164 | - */ |
|
| 159 | + * Insert given XML relative to this element's position |
|
| 160 | + * |
|
| 161 | + * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 162 | + * @param string $xml |
|
| 163 | + * @return void |
|
| 164 | + */ |
|
| 165 | 165 | public function insertAdjacentXML(string $where, string $xml): void |
| 166 | 166 | { |
| 167 | 167 | $fragment = $this->ownerDocument->createDocumentFragment(); |
@@ -171,21 +171,21 @@ discard block |
||
| 171 | 171 | } |
| 172 | 172 | |
| 173 | 173 | /** |
| 174 | - * Evaluate and return the result of a given XPath query using this element as context node |
|
| 175 | - * |
|
| 176 | - * @param string $expr XPath expression |
|
| 177 | - * @return DOMNodeList |
|
| 178 | - */ |
|
| 174 | + * Evaluate and return the result of a given XPath query using this element as context node |
|
| 175 | + * |
|
| 176 | + * @param string $expr XPath expression |
|
| 177 | + * @return DOMNodeList |
|
| 178 | + */ |
|
| 179 | 179 | public function query(string $expr): DOMNodeList |
| 180 | 180 | { |
| 181 | 181 | return $this->ownerDocument->query($expr, $this); |
| 182 | 182 | } |
| 183 | 183 | |
| 184 | 184 | /** |
| 185 | - * Remove this element from the document |
|
| 186 | - * |
|
| 187 | - * @return void |
|
| 188 | - */ |
|
| 185 | + * Remove this element from the document |
|
| 186 | + * |
|
| 187 | + * @return void |
|
| 188 | + */ |
|
| 189 | 189 | public function remove(): void |
| 190 | 190 | { |
| 191 | 191 | if (!isset($this->parentNode)) |
@@ -196,11 +196,11 @@ discard block |
||
| 196 | 196 | } |
| 197 | 197 | |
| 198 | 198 | /** |
| 199 | - * Replace this element with given nodes/text |
|
| 200 | - * |
|
| 201 | - * @param DOMNode|string $nodes |
|
| 202 | - * @return void |
|
| 203 | - */ |
|
| 199 | + * Replace this element with given nodes/text |
|
| 200 | + * |
|
| 201 | + * @param DOMNode|string $nodes |
|
| 202 | + * @return void |
|
| 203 | + */ |
|
| 204 | 204 | public function replaceWith(...$nodes): void |
| 205 | 205 | { |
| 206 | 206 | if (!isset($this->parentNode)) |
@@ -219,11 +219,11 @@ discard block |
||
| 219 | 219 | } |
| 220 | 220 | |
| 221 | 221 | /** |
| 222 | - * Add namespace declarations that may be missing in given XML |
|
| 223 | - * |
|
| 224 | - * @param string $xml Original XML |
|
| 225 | - * @return string Modified XML |
|
| 226 | - */ |
|
| 222 | + * Add namespace declarations that may be missing in given XML |
|
| 223 | + * |
|
| 224 | + * @param string $xml Original XML |
|
| 225 | + * @return string Modified XML |
|
| 226 | + */ |
|
| 227 | 227 | protected function addMissingNamespaceDeclarations(string $xml): string |
| 228 | 228 | { |
| 229 | 229 | preg_match_all('(xmlns:\\K[-\\w]++(?==))', $xml, $m); |
@@ -248,12 +248,12 @@ discard block |
||
| 248 | 248 | } |
| 249 | 249 | |
| 250 | 250 | /** |
| 251 | - * Insert given node relative to this element's position |
|
| 252 | - * |
|
| 253 | - * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 254 | - * @param DOMNode $node |
|
| 255 | - * @return void |
|
| 256 | - */ |
|
| 251 | + * Insert given node relative to this element's position |
|
| 252 | + * |
|
| 253 | + * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 254 | + * @param DOMNode $node |
|
| 255 | + * @return void |
|
| 256 | + */ |
|
| 257 | 257 | protected function insertAdjacentNode(string $where, DOMNode $node): void |
| 258 | 258 | { |
| 259 | 259 | $where = strtolower($where); |
@@ -280,13 +280,13 @@ discard block |
||
| 280 | 280 | } |
| 281 | 281 | |
| 282 | 282 | /** |
| 283 | - * Create and insert an element at given position |
|
| 284 | - * |
|
| 285 | - * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 286 | - * @param string $nodeName Element's nodeName |
|
| 287 | - * @param string $text Text content |
|
| 288 | - * @return self |
|
| 289 | - */ |
|
| 283 | + * Create and insert an element at given position |
|
| 284 | + * |
|
| 285 | + * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 286 | + * @param string $nodeName Element's nodeName |
|
| 287 | + * @param string $text Text content |
|
| 288 | + * @return self |
|
| 289 | + */ |
|
| 290 | 290 | protected function insertElement(string $where, string $nodeName, string $text): self |
| 291 | 291 | { |
| 292 | 292 | $text = htmlspecialchars($text, ENT_NOQUOTES); |
@@ -306,12 +306,12 @@ discard block |
||
| 306 | 306 | } |
| 307 | 307 | |
| 308 | 308 | /** |
| 309 | - * Insert given text relative to this element's position |
|
| 310 | - * |
|
| 311 | - * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 312 | - * @param string $text |
|
| 313 | - * @return DOMText |
|
| 314 | - */ |
|
| 309 | + * Insert given text relative to this element's position |
|
| 310 | + * |
|
| 311 | + * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 312 | + * @param string $text |
|
| 313 | + * @return DOMText |
|
| 314 | + */ |
|
| 315 | 315 | protected function insertText(string $where, string $text): DOMText |
| 316 | 316 | { |
| 317 | 317 | $node = $this->ownerDocument->createTextNode($text); |
@@ -321,13 +321,13 @@ discard block |
||
| 321 | 321 | } |
| 322 | 322 | |
| 323 | 323 | /** |
| 324 | - * Create and insert an XSL element at given position |
|
| 325 | - * |
|
| 326 | - * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 327 | - * @param string $localName Element's localName |
|
| 328 | - * @param array $arguments Arguments passed to the Document::create* function |
|
| 329 | - * @return self |
|
| 330 | - */ |
|
| 324 | + * Create and insert an XSL element at given position |
|
| 325 | + * |
|
| 326 | + * @param string $where One of 'beforebegin', 'afterbegin', 'beforeend', 'afterend' |
|
| 327 | + * @param string $localName Element's localName |
|
| 328 | + * @param array $arguments Arguments passed to the Document::create* function |
|
| 329 | + * @return self |
|
| 330 | + */ |
|
| 331 | 331 | protected function insertXslElement(string $where, string $localName, array $arguments): self |
| 332 | 332 | { |
| 333 | 333 | $callback = [$this->ownerDocument, 'createXsl' . ucfirst($localName)]; |