GitHub Access Token became invalid

It seems like the GitHub access token used for retrieving details about this repository from GitHub became invalid. This might prevent certain types of inspections from being run (in particular, everything related to pull requests).
Please ask an admin of your repository to re-new the access token on this website.
Completed
Pull Request — master (#19)
by
unknown
01:47
created

HtmlPageCrawler::setStyle()   B

Complexity

Conditions 5
Paths 5

Size

Total Lines 16
Code Lines 10

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 13
CRAP Score 5

Importance

Changes 1
Bugs 1 Features 0
Metric Value
dl 0
loc 16
ccs 13
cts 13
cp 1
rs 8.8571
c 1
b 1
f 0
cc 5
eloc 10
nc 5
nop 2
crap 5
1
<?php
2
namespace Wa72\HtmlPageDom;
3
4
use Symfony\Component\DomCrawler\Crawler;
5
6
/**
7
 * Extends \Symfony\Component\DomCrawler\Crawler by adding tree manipulation functions
8
 * for HTML documents inspired by jQuery such as html(), css(), append(), prepend(), before(),
9
 * addClass(), removeClass()
10
 *
11
 * @author Christoph Singer
12
 * @license MIT
13
 *
14
 */
15
class HtmlPageCrawler extends Crawler
0 ignored issues
show
Complexity introduced by
This class has 50 public methods and attributes which exceeds the configured maximum of 45.

The number of this metric differs depending on the chosen design (inheritance vs. composition). For inheritance, the number should generally be a bit lower.

A high number indicates a reusable class. It might also make the class harder to change without breaking other classes though.

Loading history...
Complexity introduced by
This class has 1090 lines of code which exceeds the configured maximum of 1000.

Really long classes often contain too much logic and violate the single responsibility principle.

We suggest to take a look at the “Code” section for options on how to refactor this code.

Loading history...
Complexity introduced by
This class has a complexity of 160 which exceeds the configured maximum of 50.

The class complexity is the sum of the complexity of all methods. A very high value is usually an indication that your class does not follow the single reponsibility principle and does more than one job.

Some resources for further reading:

You can also find more detailed suggestions for refactoring in the “Code” section of your repository.

Loading history...
16
{
17
    /**
18
     * the (internal) root element name used when importing html fragments
19
     * */
20
    const FRAGMENT_ROOT_TAGNAME = '_root';
21
22
    /**
23
     * Get an HtmlPageCrawler object from a HTML string, DOMNode, DOMNodeList or HtmlPageCrawler
24
     *
25
     * This is the equivalent to jQuery's $() function when used for wrapping DOMNodes or creating DOMElements from HTML code.
26
     *
27
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList|array $content
28
     * @return HtmlPageCrawler
29
     * @api
30
     */
31 11
    public static function create($content)
32
    {
33 11
        if ($content instanceof HtmlPageCrawler) {
34 3
            return $content;
35
        } else {
36 11
            return new HtmlPageCrawler($content);
37
        }
38
    }
39
40
    /**
41
     * Adds the specified class(es) to each element in the set of matched elements.
42
     *
43
     * @param string $name One or more space-separated classes to be added to the class attribute of each matched element.
44
     * @return HtmlPageCrawler $this for chaining
45
     * @api
46
     */
47 1
    public function addClass($name)
48
    {
49 1
        foreach ($this as $node) {
50 1
            if ($node instanceof \DOMElement) {
51
                /** @var \DOMElement $node */
52 1
                $classes = preg_split('/\s+/s', $node->getAttribute('class'));
53 1
                $found = false;
54 1
                $count = count($classes);
55 1
                for ($i = 0; $i < $count; $i++) {
56 1
                    if ($classes[$i] == $name) {
57
                        $found = true;
58
                    }
59 1
                }
60 1
                if (!$found) {
61 1
                    $classes[] = $name;
62 1
                    $node->setAttribute('class', trim(join(' ', $classes)));
63 1
                }
64 1
            }
65 1
        }
66 1
        return $this;
67
    }
68
69
    /**
70
     * Insert content, specified by the parameter, after each element in the set of matched elements.
71
     *
72
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $content
73
     * @return HtmlPageCrawler $this for chaining
74
     * @api
75
     */
76 3
    public function after($content)
77
    {
78 3
        $content = self::create($content);
79 3
        $newnodes = array();
80 3
        foreach ($this as $i => $node) {
81
            /** @var \DOMNode $node */
82 3
            $refnode = $node->nextSibling;
83 3
            foreach ($content as $newnode) {
84
                /** @var \DOMNode $newnode */
85 3
                $newnode = static::importNewnode($newnode, $node, $i);
86 3
                if ($refnode === null) {
87 3
                    $node->parentNode->appendChild($newnode);
88 3
                } else {
89
                    $node->parentNode->insertBefore($newnode, $refnode);
90
                }
91 3
                $newnodes[] = $newnode;
92 3
            }
93 3
        }
94 3
        $content->clear();
95 3
        $content->add($newnodes);
96 3
        return $this;
97
    }
98
99
    /**
100
     * Insert HTML content as child nodes of each element after existing children
101
     *
102
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $content HTML code fragment or DOMNode to append
103
     * @return HtmlPageCrawler $this for chaining
104
     * @api
105
     */
106 2
    public function append($content)
107
    {
108 2
        $content = self::create($content);
109 2
        $newnodes = array();
110 2
        foreach ($this as $i => $node) {
111
            /** @var \DOMNode $node */
112 2
            foreach ($content as $newnode) {
113
                /** @var \DOMNode $newnode */
114 2
                $newnode = static::importNewnode($newnode, $node, $i);
115
//                if ($newnode->ownerDocument !== $node->ownerDocument) {
116
//                    $newnode = $node->ownerDocument->importNode($newnode, true);
117
//                } else {
118
//                    if ($i > 0) {
119
//                        $newnode = $newnode->cloneNode(true);
120
//                    }
121
//                }
122 2
                $node->appendChild($newnode);
123 2
                $newnodes[] = $newnode;
124 2
            }
125 2
        }
126 2
        $content->clear();
127 2
        $content->add($newnodes);
128 2
        return $this;
129
    }
130
131
    /**
132
     * Insert every element in the set of matched elements to the end of the target.
133
     *
134
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $element
135
     * @return \Wa72\HtmlPageDom\HtmlPageCrawler A new Crawler object containing all elements appended to the target elements
136
     * @api
137
     */
138 1
    public function appendTo($element)
139
    {
140 1
        $e = self::create($element);
141 1
        $newnodes = array();
142 1
        foreach ($e as $i => $node) {
143
            /** @var \DOMNode $node */
144 1
            foreach ($this as $newnode) {
145
                /** @var \DOMNode $newnode */
146 1
                $newnode = static::importNewnode($newnode, $node, $i);
147 1
                $node->appendChild($newnode);
148 1
                $newnodes[] = $newnode;
149 1
            }
150 1
        }
151 1
        return self::create($newnodes);
152
    }
153
154
    /**
155
     * Returns the attribute value of the first node of the list, or sets an attribute on each element
156
     *
157
     * @see HtmlPageCrawler::getAttribute()
158
     * @see HtmlPageCrawler::setAttribute
159
     *
160
     * @param string $name
161
     * @param null|string $value
162
     * @return null|string|HtmlPageCrawler
163
     * @api
164
     */
165 1
    public function attr($name, $value = null)
166
    {
167 1
        if ($value === null) {
168 1
            return $this->getAttribute($name);
169
        } else {
170 1
            return $this->setAttribute($name, $value);
0 ignored issues
show
Bug Best Practice introduced by
The return type of return $this->setAttribute($name, $value); (Wa72\HtmlPageDom\HtmlPageCrawler) is incompatible with the return type of the parent method Symfony\Component\DomCrawler\Crawler::attr of type string|null.

If you return a value from a function or method, it should be a sub-type of the type that is given by the parent type f.e. an interface, or abstract method. This is more formally defined by the Lizkov substitution principle, and guarantees that classes that depend on the parent type can use any instance of a child type interchangably. This principle also belongs to the SOLID principles for object oriented design.

Let’s take a look at an example:

class Author {
    private $name;

    public function __construct($name) {
        $this->name = $name;
    }

    public function getName() {
        return $this->name;
    }
}

abstract class Post {
    public function getAuthor() {
        return 'Johannes';
    }
}

class BlogPost extends Post {
    public function getAuthor() {
        return new Author('Johannes');
    }
}

class ForumPost extends Post { /* ... */ }

function my_function(Post $post) {
    echo strtoupper($post->getAuthor());
}

Our function my_function expects a Post object, and outputs the author of the post. The base class Post returns a simple string and outputting a simple string will work just fine. However, the child class BlogPost which is a sub-type of Post instead decided to return an object, and is therefore violating the SOLID principles. If a BlogPost were passed to my_function, PHP would not complain, but ultimately fail when executing the strtoupper call in its body.

Loading history...
171
        }
172
    }
173
174
    /**
175
     * Sets an attribute on each element
176
     *
177
     * @param string $name
178
     * @param string $value
179
     * @return HtmlPageCrawler $this for chaining
180
     */
181 2
    public function setAttribute($name, $value)
182
    {
183 2
        foreach ($this as $node) {
184 2
            if ($node instanceof \DOMElement) {
185
                /** @var \DOMElement $node */
186 2
                $node->setAttribute($name, $value);
187 2
            }
188 2
        }
189 2
        return $this;
190
    }
191
192
    /**
193
     * Returns the attribute value of the first node of the list.
194
     *
195
     * @param string $name The attribute name
196
     * @return string|null The attribute value or null if the attribute does not exist
197
     * @throws \InvalidArgumentException When current node is empty
198
     *
199
     */
200 1
    public function getAttribute($name)
201
    {
202 1
        if (!count($this)) {
203
            throw new \InvalidArgumentException('The current node list is empty.');
204
        }
205 1
        $node = $this->getNode(0);
206 1
        return $node->hasAttribute($name) ? $node->getAttribute($name) : null;
207
    }
208
209
    /**
210
     * Insert content, specified by the parameter, before each element in the set of matched elements.
211
     *
212
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $content
213
     * @return HtmlPageCrawler $this for chaining
214
     * @api
215
     */
216 2
    public function before($content)
217
    {
218 2
        $content = self::create($content);
219 2
        $newnodes = array();
220 2
        foreach ($this as $i => $node) {
221
            /** @var \DOMNode $node */
222 2
            foreach ($content as $newnode) {
223
                /** @var \DOMNode $newnode */
224 2
                $newnode = static::importNewnode($newnode, $node, $i);
225 2
                $node->parentNode->insertBefore($newnode, $node);
226 2
                $newnodes[] = $newnode;
227 2
            }
228 2
        }
229 2
        $content->clear();
230 2
        $content->add($newnodes);
231 2
        return $this;
232
    }
233
234
    /**
235
     * Create a deep copy of the set of matched elements.
236
     *
237
     * Equivalent to clone() in jQuery (clone is not a valid PHP function name)
238
     *
239
     * @return HtmlPageCrawler
240
     * @api
241
     */
242 1
    public function makeClone()
243
    {
244 1
        return clone $this;
245
    }
246
247 1
    public function __clone()
248
    {
249 1
        $newnodes = array();
250 1
        foreach ($this as $node) {
251
            /** @var \DOMNode $node */
252 1
            $newnodes[] = $node->cloneNode(true);
253 1
        }
254 1
        $this->clear();
255 1
        $this->add($newnodes);
256 1
    }
257
258
    /**
259
     * Get one CSS style property of the first element or set it for all elements in the list
260
     *
261
     * Function is here for compatibility with jQuery; it is the same as getStyle() and setStyle()
262
     *
263
     * @see HtmlPageCrawler::getStyle()
264
     * @see HtmlPageCrawler::setStyle()
265
     *
266
     * @param string $key The name of the style property
267
     * @param null|string $value The CSS value to set, or NULL to get the current value
268
     * @return HtmlPageCrawler|string If no param is provided, returns the CSS styles of the first element
269
     * @api
270
     */
271 1
    public function css($key, $value = null)
272
    {
273 1
        if (null === $value) {
274 1
            return $this->getStyle($key);
275
        } else {
276 1
            return $this->setStyle($key, $value);
277
        }
278
    }
279
280
    /**
281
     * get one CSS style property of the first element
282
     *
283
     * @param string $key name of the property
284
     * @return string|null value of the property
285
     */
286 1
    public function getStyle($key)
287
    {
288 1
        $styles = Helpers::cssStringToArray($this->getAttribute('style'));
289 1
        return (isset($styles[$key]) ? $styles[$key] : null);
290
    }
291
292
    /**
293
     * set one CSS style property for all elements in the list
294
     *
295
     * @param string $key name of the property
296
     * @param string $value value of the property
297
     * @return HtmlPageCrawler $this for chaining
298
     */
299 1
    public function setStyle($key, $value)
300
    {
301 1
        foreach ($this as $node) {
302 1
            if ($node instanceof \DOMElement) {
303
                /** @var \DOMElement $node */
304 1
                $styles = Helpers::cssStringToArray($node->getAttribute('style'));
305 1
                if ($value != '') {
306 1
                    $styles[$key] = $value;
307 1
                } elseif (isset($styles[$key])) {
308 1
                    unset($styles[$key]);
309 1
                }
310 1
                $node->setAttribute('style', Helpers::cssArrayToString($styles));
311 1
            }
312 1
        }
313 1
        return $this;
314
    }
315
316
    /**
317
     * Removes all child nodes and text from all nodes in set
318
     *
319
     * Equivalent to jQuery's empty() function which is not a valid function name in PHP
320
     * @return HtmlPageCrawler $this
321
     * @api
322
     */
323
    public function makeEmpty()
324
    {
325
        foreach ($this as $node) {
326
            $node->nodeValue = '';
327
        }
328
        return $this;
329
    }
330
331
    /**
332
     * Determine whether any of the matched elements are assigned the given class.
333
     *
334
     * @param string $name
335
     * @return bool
336
     * @api
337
     */
338 2
    public function hasClass($name)
339
    {
340 2
        foreach ($this as $node) {
341 2
            if ($node instanceof \DOMElement && $class = $node->getAttribute('class')) {
342 2
                $classes = preg_split('/\s+/s', $class);
343 2
                if (in_array($name, $classes)) {
344 2
                    return true;
345
                }
346 1
            }
347 2
        }
348 2
        return false;
349
    }
350
351
    /**
352
     * Get the HTML contents of the first element in the set of matched elements
353
     * or set the HTML contents of every matched element.
354
     *
355
     * Function is here for compatibility with jQuery: When called with a parameter, it is
356
     * equivalent to setInnerHtml(), without parameter it is the same as getInnerHtml()
357
     *
358
     * @see HtmlPageCrawler::setInnerHtml()
359
     * @see HtmlPageCrawler::getInnerHtml()
360
     *
361
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList|null $html The HTML content to set, or NULL to get the current content
362
     *
363
     * @return HtmlPageCrawler|string If no param is provided, returns the HTML content of the first element
364
     * @api
365
     */
366
    public function html($html = null)
367
    {
368
        if (null === $html) {
369
            return $this->getInnerHtml();
370
        } else {
371
            $this->setInnerHtml($html);
372
            return $this;
373
        }
374
    }
375
376
    /**
377
     * Get the innerHTML contents of the first element
378
     *
379
     * @return string HTML code fragment
380
     */
381 2
    public function getInnerHtml()
382
    {
383 2
        $html = '';
384 2
        foreach ($this->getNode(0)->childNodes as $node) {
385 2
            $html .= trim($node->ownerDocument->saveHTML($node));
386 2
        }
387 2
        return $html;
388
    }
389
390
    /**
391
     * Set the HTML contents of each element
392
     *
393
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $content HTML code fragment
394
     * @return HtmlPageCrawler $this for chaining
395
     */
396 2
    public function setInnerHtml($content)
397
    {
398 2
        $content = self::create($content);
399 2
        foreach ($this as $node) {
400 2
            $node->nodeValue = '';
401 2
            foreach ($content as $newnode) {
402
                /** @var \DOMNode $node */
403
                /** @var \DOMNode $newnode */
404 2
                $newnode = static::importNewnode($newnode, $node);
405 2
                $node->appendChild($newnode);
406 2
            }
407 2
        }
408 2
        return $this;
409
    }
410
411
    /**
412
     * Insert every element in the set of matched elements after the target.
413
     *
414
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $element
415
     * @return \Wa72\HtmlPageDom\HtmlPageCrawler A new Crawler object containing all elements appended to the target elements
416
     * @api
417
     */
418 1
    public function insertAfter($element)
419
    {
420 1
        $e = self::create($element);
421 1
        $newnodes = array();
422 1
        foreach ($e as $i => $node) {
423
            /** @var \DOMNode $node */
424 1
            $refnode = $node->nextSibling;
425 1
            foreach ($this as $newnode) {
426
                /** @var \DOMNode $newnode */
427 1
                $newnode = static::importNewnode($newnode, $node, $i);
428 1
                if ($refnode === null) {
429 1
                    $node->parentNode->appendChild($newnode);
430 1
                } else {
431 1
                    $node->parentNode->insertBefore($newnode, $refnode);
432
                }
433 1
                $newnodes[] = $newnode;
434 1
            }
435 1
        }
436 1
        return self::create($newnodes);
437
    }
438
439
    /**
440
     * Insert every element in the set of matched elements before the target.
441
     *
442
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $element
443
     * @return \Wa72\HtmlPageDom\HtmlPageCrawler A new Crawler object containing all elements appended to the target elements
444
     * @api
445
     */
446 1
    public function insertBefore($element)
447
    {
448 1
        $e = self::create($element);
449 1
        $newnodes = array();
450 1
        foreach ($e as $i => $node) {
451
            /** @var \DOMNode $node */
452 1
            foreach ($this as $newnode) {
453
                /** @var \DOMNode $newnode */
454 1
                $newnode = static::importNewnode($newnode, $node, $i);
455 1
                $node->parentNode->insertBefore($newnode, $node);
456 1
                $newnodes[] = $newnode;
457 1
            }
458 1
        }
459 1
        return self::create($newnodes);
460
    }
461
462
    /**
463
     * Insert content, specified by the parameter, to the beginning of each element in the set of matched elements.
464
     *
465
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $content HTML code fragment
466
     * @return HtmlPageCrawler $this for chaining
467
     * @api
468
     */
469 2
    public function prepend($content)
470
    {
471 2
        $content = self::create($content);
472 2
        $newnodes = array();
473 2
        foreach ($this as $i => $node) {
474 2
            $refnode = $node->firstChild;
475
            /** @var \DOMNode $node */
476 2
            foreach ($content as $newnode) {
477
                /** @var \DOMNode $newnode */
478 2
                $newnode = static::importNewnode($newnode, $node, $i);
479 2
                if ($refnode === null) {
480
                    $node->appendChild($newnode);
481
                } else {
482 2
                    $node->insertBefore($newnode, $refnode);
483
                }
484 2
                $newnodes[] = $newnode;
485 2
            }
486 2
        }
487 2
        $content->clear();
488 2
        $content->add($newnodes);
489 2
        return $this;
490
    }
491
492
    /**
493
     * Insert every element in the set of matched elements to the beginning of the target.
494
     *
495
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $element
496
     * @return \Wa72\HtmlPageDom\HtmlPageCrawler A new Crawler object containing all elements prepended to the target elements
497
     * @api
498
     */
499
    public function prependTo($element)
500
    {
501
        $e = self::create($element);
502
        $newnodes = array();
503
        foreach ($e as $i => $node) {
504
            $refnode = $node->firstChild;
505
            /** @var \DOMNode $node */
506
            foreach ($this as $newnode) {
507
                /** @var \DOMNode $newnode */
508
                $newnode = static::importNewnode($newnode, $node, $i);
509
                if ($refnode === null) {
510
                    $node->appendChild($newnode);
511
                } else {
512
                    $node->insertBefore($newnode, $refnode);
513
                }
514
                $newnodes[] = $newnode;
515
            }
516
        }
517
        return self::create($newnodes);
518
    }
519
520
    /**
521
     * Remove the set of matched elements from the DOM.
522
     *
523
     * (as opposed to Crawler::clear() which detaches the nodes only from Crawler
524
     * but leaves them in the DOM)
525
     *
526
     * @api
527
     */
528 2
    public function remove()
529
    {
530 2
        foreach ($this as $node) {
531
            /**
532
             * @var \DOMNode $node
533
             */
534 2
            if ($node->parentNode instanceof \DOMElement) {
535 2
                $node->parentNode->removeChild($node);
536 2
            }
537 2
        }
538 2
        $this->clear();
539 2
    }
540
541
    /**
542
     * Remove an attribute from each element in the set of matched elements.
543
     *
544
     * Alias for removeAttribute for compatibility with jQuery
545
     *
546
     * @param string $name
547
     * @return HtmlPageCrawler
548
     * @api
549
     */
550 1
    public function removeAttr($name)
551
    {
552 1
        return $this->removeAttribute($name);
553
    }
554
555
    /**
556
     * Remove an attribute from each element in the set of matched elements.
557
     *
558
     * @param string $name
559
     * @return HtmlPageCrawler
560
     */
561 1
    public function removeAttribute($name)
562
    {
563 1
        foreach ($this as $node) {
564 1
            if ($node instanceof \DOMElement) {
565
                /** @var \DOMElement $node */
566 1
                if ($node->hasAttribute($name)) {
567 1
                    $node->removeAttribute($name);
568 1
                }
569 1
            }
570 1
        }
571 1
        return $this;
572
    }
573
574
    /**
575
     * Remove a class from each element in the list
576
     *
577
     * @param string $name
578
     * @return HtmlPageCrawler $this for chaining
579
     * @api
580
     */
581 2
    public function removeClass($name)
582
    {
583 2
        foreach ($this as $node) {
584 2
            if ($node instanceof \DOMElement) {
585
                /** @var \DOMElement $node */
586 2
                $classes = preg_split('/\s+/s', $node->getAttribute('class'));
587 2
                $count = count($classes);
588 2
                for ($i = 0; $i < $count; $i++) {
589 2
                    if ($classes[$i] == $name) {
590 2
                        unset($classes[$i]);
591 2
                    }
592 2
                }
593 2
                $node->setAttribute('class', trim(join(' ', $classes)));
594 2
            }
595 2
        }
596 2
        return $this;
597
    }
598
599
    /**
600
     * Replace each target element with the set of matched elements.
601
     *
602
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $element
603
     * @return \Wa72\HtmlPageDom\HtmlPageCrawler A new Crawler object containing all elements appended to the target elements
604
     * @api
605
     */
606 2
    public function replaceAll($element)
607
    {
608 2
        $e = self::create($element);
609 2
        $newnodes = array();
610 2
        foreach ($e as $i => $node) {
611
            /** @var \DOMNode $node */
612 2
            $parent = $node->parentNode;
613 2
            $refnode  = $node->nextSibling;
614 2
            foreach ($this as $j => $newnode) {
615
                /** @var \DOMNode $newnode */
616 2
                $newnode = static::importNewnode($newnode, $node, $i);
617 2
                if ($j == 0) {
618 2
                    $parent->replaceChild($newnode, $node);
619 2
                } else {
620 1
                    $parent->insertBefore($newnode, $refnode);
621
                }
622 2
                $newnodes[] = $newnode;
623 2
            }
624 2
        }
625 2
        return self::create($newnodes);
626
    }
627
628
    /**
629
     * Replace each element in the set of matched elements with the provided new content and return the set of elements that was removed.
630
     *
631
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $content
632
     * @return \Wa72\HtmlPageDom\HtmlPageCrawler $this for chaining
633
     * @api
634
     */
635 2
    public function replaceWith($content)
636
    {
637 2
        $content = self::create($content);
638 2
        $newnodes = array();
639 2
        foreach ($this as $i => $node) {
640
            /** @var \DOMNode $node */
641 2
            $parent = $node->parentNode;
642 2
            $refnode  = $node->nextSibling;
643 2
            foreach ($content as $j => $newnode) {
644
                /** @var \DOMNode $newnode */
645 2
                $newnode = static::importNewnode($newnode, $node, $i);
646 2
                if ($j == 0) {
647 2
                    $parent->replaceChild($newnode, $node);
648 2
                } else {
649 1
                    $parent->insertBefore($newnode, $refnode);
650
                }
651 2
                $newnodes[] = $newnode;
652 2
            }
653 2
        }
654 2
        $content->clear();
655 2
        $content->add($newnodes);
656 2
        return $this;
657
    }
658
659
    /**
660
     * Get the combined text contents of each element in the set of matched elements, including their descendants,
661
     * or set the text contents of the matched elements.
662
     *
663
     * ATTENTION: Contrary to the parent Crawler class, which returns the text from the first element only,
664
     * this functions returns the combined text of all elements (as jQuery does). If this is not what you need you
665
     * must call ->first() before calling ->text(), e.g.
666
     *
667
     * in Symfony\DOMCrawler\Crawler: $c->filter('p')->text() returns the text of the first paragraph only
668
     * in HtmlPageCrawler you need to call: $c->filter('p')->first()->text()
669
     *
670
     * @param null|string $text
671
     * @return string|HtmlPageCrawler
672
     * @api
673
     */
674 1
    public function text($text = null)
675
    {
676 1
        if ($text === null) {
677 1
            $text = '';
678 1
            foreach ($this as $node) {
679
                /** @var \DOMNode $node */
680 1
                $text .= $node->nodeValue;
681 1
            }
682 1
            return $text;
683
        } else {
684 1
            foreach ($this as $node) {
685
                /** @var \DOMNode $node */
686 1
                $node->nodeValue = $text;
687 1
            }
688 1
            return $this;
689
        }
690
    }
691
692
693
    /**
694
     * Add or remove one or more classes from each element in the set of matched elements, depending the class’s presence.
695
     *
696
     * @param string $classname One or more classnames separated by spaces
697
     * @return \Wa72\HtmlPageDom\HtmlPageCrawler $this for chaining
698
     * @api
699
     */
700 1
    public function toggleClass($classname)
701
    {
702 1
        $classes = explode(' ', $classname);
703 1
        foreach ($this as $i => $node) {
704 1
            $c = self::create($node);
705
            /** @var \DOMNode $node */
706 1
            foreach ($classes as $class) {
707 1
                if ($c->hasClass($class)) {
708 1
                    $c->removeClass($class);
709 1
                } else {
710 1
                    $c->addClass($class);
711
                }
712 1
            }
713 1
        }
714 1
        return $this;
715
    }
716
717
    /**
718
     * Remove the parents of the set of matched elements from the DOM, leaving the matched elements in their place.
719
     *
720
     * @return \Wa72\HtmlPageDom\HtmlPageCrawler $this for chaining
721
     * @api
722
     */
723 1
    public function unwrap()
724
    {
725 1
        $parents = array();
726 1
        foreach($this as $i => $node) {
0 ignored issues
show
Coding Style introduced by
Expected 1 space after FOREACH keyword; 0 found
Loading history...
727 1
            $parents[] = $node->parentNode;
728 1
        }
729
730 1
        self::create($parents)->unwrapInner();
731 1
        return $this;
732
    }
733
734
    /**
735
     * Remove the matched elements, but promote the children to take their place.
736
     *
737
     * @return \Wa72\HtmlPageDom\HtmlPageCrawler $this for chaining
738
     * @api
739
     */
740 1
    public function unwrapInner()
741
    {
742 1
        foreach($this as $i => $node) {
0 ignored issues
show
Coding Style introduced by
Expected 1 space after FOREACH keyword; 0 found
Loading history...
743 1
            if (!$node->parentNode instanceof \DOMElement) {
744
                throw new \InvalidArgumentException('DOMElement does not have a parent DOMElement node.');
745
            }
746
747
            /** @var \DOMNode[] $children */
748 1
            $children = iterator_to_array($node->childNodes);
749 1
            foreach ($children as $child) {
750 1
                $node->parentNode->insertBefore($child, $node);
751 1
            }
752
753 1
            $node->parentNode->removeChild($node);
754 1
        }
755 1
    }
756
757
758
    /**
759
     * Wrap an HTML structure around each element in the set of matched elements
760
     *
761
     * The HTML structure must contain only one root node, e.g.:
762
     * Works: <div><div></div></div>
763
     * Does not work: <div></div><div></div>
764
     *
765
     * @param string|HtmlPageCrawler|\DOMNode $wrappingElement
766
     * @return HtmlPageCrawler $this for chaining
767
     * @api
768
     */
769 1
    public function wrap($wrappingElement)
770
    {
771 1
        $content = self::create($wrappingElement);
772 1
        $newnodes = array();
773 1
        foreach ($this as $i => $node) {
774
            /** @var \DOMNode $node */
775 1
            $newnode = $content->getNode(0);
776
            /** @var \DOMNode $newnode */
777
//            $newnode = static::importNewnode($newnode, $node, $i);
778 1
            if ($newnode->ownerDocument !== $node->ownerDocument) {
779 1
                $newnode = $node->ownerDocument->importNode($newnode, true);
780 1
            } else {
781
                if ($i > 0) {
782
                    $newnode = $newnode->cloneNode(true);
783
                }
784
            }
785 1
            $oldnode = $node->parentNode->replaceChild($newnode, $node);
786 1
            while ($newnode->hasChildNodes()) {
787 1
                $elementFound = false;
788 1
                foreach ($newnode->childNodes as $child) {
789 1
                    if ($child instanceof \DOMElement) {
790 1
                        $newnode = $child;
791 1
                        $elementFound = true;
792 1
                        break;
793
                    }
794 1
                }
795 1
                if (!$elementFound) {
796
                    break;
797
                }
798 1
            }
799 1
            $newnode->appendChild($oldnode);
800 1
            $newnodes[] = $newnode;
801 1
        }
802 1
        $content->clear();
803 1
        $content->add($newnodes);
804 1
        return $this;
805
    }
806
807
    /**
808
     * Wrap an HTML structure around all elements in the set of matched elements.
809
     *
810
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $content
811
     * @throws \LogicException
812
     * @return \Wa72\HtmlPageDom\HtmlPageCrawler $this for chaining
813
     * @api
814
     */
815 1
    public function wrapAll($content)
816
    {
817 1
        $content = self::create($content);
818 1
        $parent = $this->getNode(0)->parentNode;
819 1
        foreach ($this as $i => $node) {
820
            /** @var \DOMNode $node */
821 1
            if ($node->parentNode !== $parent) {
822
                throw new \LogicException('Nodes to be wrapped with wrapAll() must all have the same parent');
823
            }
824 1
        }
825
826 1
        $newnode = $content->getNode(0);
827
        /** @var \DOMNode $newnode */
828 1
        $newnode = static::importNewnode($newnode, $parent);
829
830 1
        $newnode = $parent->insertBefore($newnode,$this->getNode(0));
831 1
        $content->clear();
832 1
        $content->add($newnode);
833
834 1
        while ($newnode->hasChildNodes()) {
835
            $elementFound = false;
836
            foreach ($newnode->childNodes as $child) {
837
                if ($child instanceof \DOMElement) {
838
                    $newnode = $child;
839
                    $elementFound = true;
840
                    break;
841
                }
842
            }
843
            if (!$elementFound) {
844
                break;
845
            }
846
        }
847 1
        foreach ($this as $i => $node) {
848
            /** @var \DOMNode $node */
849 1
            $newnode->appendChild($node);
850 1
        }
851 1
        return $this;
852
    }
853
854
    /**
855
     * Wrap an HTML structure around the content of each element in the set of matched elements.
856
     *
857
     * @param string|HtmlPageCrawler|\DOMNode|\DOMNodeList $content
858
     * @return \Wa72\HtmlPageDom\HtmlPageCrawler $this for chaining
859
     * @api
860
     */
861 1
    public function wrapInner($content)
862
    {
863 1
        foreach ($this as $i => $node) {
864
            /** @var \DOMNode $node */
865 1
            self::create($node->childNodes)->wrapAll($content);
866 1
        }
867 1
        return $this;
868
    }
869
870
    /**
871
     * Get the HTML code fragment of all elements and their contents.
872
     *
873
     * If the first node contains a complete HTML document return the
874
     * DocType if exists
875
     *
876
     * @return string HTML code (fragment)
877
     * @api
878
     */
879 3
    public function saveHTML()
880
    {
881 3
        $html = '';
882 3
        if ( $this->isHtmlDocument() ) {
0 ignored issues
show
Coding Style introduced by
Expected 0 spaces before closing bracket; 1 found
Loading history...
883
            /* Output DocType if exists */
884 1
            $documentHtml = $this->getDOMDocument()->saveHTML();
885 1
            $html .= preg_match("/<!DOCTYPE.*?>/is", $documentHtml, $match) ? $match[0]."\n" : '';
886 1
        }
887 3
        foreach ($this as $node) {
888 3
            $html .= trim($node->ownerDocument->saveHTML($node));
889 3
        }
890 3
        return $html;
891
    }
892
893
    public function __toString()
894
    {
895
        return $this->saveHTML();
896
    }
897
898
    /**
899
     * checks whether the first node contains a complete html document
900
     * (as opposed to a document fragment)
901
     *
902
     * @return boolean
903
     */
904 3
    public function isHtmlDocument()
905
    {
906 3
        $node = $this->getNode(0);
907
        if ($node instanceof \DOMElement
908 3
            && $node->ownerDocument instanceof \DOMDocument
909 3
            && $node->ownerDocument->documentElement === $node
910 3
            && $node->nodeName == 'html'
911 3
        ) {
912 1
            return true;
913
        } else {
914 3
            return false;
915
        }
916
    }
917
918
    /**
919
     * get ownerDocument of the first element
920
     *
921
     * @return \DOMDocument|null
922
     */
923
    public function getDOMDocument()
924
    {
925
        $node = $this->getNode(0); 
926
        $r = null;
927
        if ($node instanceof \DOMElement
928
            && $node->ownerDocument instanceof \DOMDocument
929
        ) {
930
            $r = $node->ownerDocument;
931
        }
932
        return $r;
933
    }
934
935
    /**
936
     * Filters the list of nodes with a CSS selector.
937
     *
938
     * @param string $selector
939
     * @return HtmlPageCrawler
940
     */
941 6
    public function filter($selector)
942
    {
943 6
        return parent::filter($selector);
944
    }
945
946
    /**
947
     * Filters the list of nodes with an XPath expression.
948
     *
949
     * @param string $xpath An XPath expression
950
     *
951
     * @return HtmlPageCrawler A new instance of Crawler with the filtered list of nodes
952
     *
953
     * @api
954
     */
955 1
    public function filterXPath($xpath)
956
    {
957 1
        return parent::filterXPath($xpath);
958
    }
959
960
    /**
961
     * Adds HTML/XML content to the HtmlPageCrawler object (but not to the DOM of an already attached node).
962
     *
963
     * Function overriden from Crawler because HTML fragments are always added as complete documents there
964
     *
965
     *
966
     * @param string      $content A string to parse as HTML/XML
967
     * @param null|string $type    The content type of the string
968
     *
969
     * @return null|void
970
     */
971 12
    public function addContent($content, $type = null)
972
    {
973 12
        if (empty($type)) {
974 12
            $type = 'text/html;charset=UTF-8';
975 12
        }
976 12
        if (substr($type, 0, 9) == 'text/html' && !preg_match('/<html\b[^>]*>/i', $content)) {
977
            // string contains no <html> Tag => no complete document but an HTML fragment!
978 10
            $this->addHtmlFragment($content);
979 10
        } else {
980 2
            parent::addContent($content, $type);
981
        }
982 12
    }
983
984 10
    public function addHtmlFragment($content, $charset = 'UTF-8')
985
    {
986 10
        $d = new \DOMDocument('1.0', $charset);
987 10
        $root = $d->appendChild($d->createElement(self::FRAGMENT_ROOT_TAGNAME));
988 10
        $bodynode = Helpers::getBodyNodeFromHtmlFragment($content, $charset);
989 10
        foreach ($bodynode->childNodes as $child) {
990 10
            $inode = $root->appendChild($d->importNode($child, true));
991 10
            if ($inode) {
992 10
                $this->addNode($inode);
993 10
            }
994 10
        }
995 10
    }
996
997
    /**
998
     * returns the first node
999
     * deprecated, use getNode(0) instead
1000
     *
1001
     * @return \DOMNode|null
1002
     * @deprecated
1003
     * @see Crawler::getNode
1004
     */
1005 1
    public function getFirstNode()
1006
    {
1007 1
        return $this->getNode(0);
1008
    }
1009
1010
    /**
1011
     * @param int $position
1012
     *
1013
     * overridden from Crawler because it is not public in Symfony 2.3
1014
     * TODO: throw away as soon as we don't need to support SF 2.3 any more
1015
     *
1016
     * @return \DOMElement|null
1017
     */
1018 5
    public function getNode($position)
1019
    {
1020 5
        return parent::getNode($position);
1021
    }
1022
1023
    /**
1024
     * Returns the node name of the first node of the list.
1025
     *
1026
     * in Crawler (parent), this function will be available starting with 2.6.0,
1027
     * therefore this method be removed from here as soon as we don't need to keep compatibility
1028
     * with Symfony < 2.6
1029
     *
1030
     * TODO: throw away as soon as we don't need to support SF 2.3 any more
1031
     *
1032
     * @return string The node name
1033
     *
1034
     * @throws \InvalidArgumentException When current node is empty
1035
     */
1036 1
    public function nodeName()
1037
    {
1038 1
        if (!count($this)) {
1039
            throw new \InvalidArgumentException('The current node list is empty.');
1040
        }
1041 1
        return $this->getNode(0)->nodeName;
1042
    }
1043
1044
    /**
1045
     * Adds a node to the current list of nodes.
1046
     *
1047
     * This method uses the appropriate specialized add*() method based
1048
     * on the type of the argument.
1049
     *
1050
     * Overwritten from parent to allow Crawler to be added
1051
     *
1052
     * @param null|\DOMNodeList|array|\DOMNode|Crawler $node A node
1053
     *
1054
     * @api
1055
     */
1056 14
    public function add($node)
1057
    {
1058 14
        if ($node instanceof Crawler) {
1059
            foreach ($node as $childnode) {
1060
                $this->addNode($childnode);
1061
            }
1062
        } else {
1063 14
            parent::add($node);
1064
        }
1065 14
    }
1066
1067
    /**
1068
     * @param \DOMNode $newnode
1069
     * @param \DOMNode $referencenode
1070
     * @param int $clone
1071
     * @return \DOMNode
1072
     */
1073 5
    protected static function importNewnode(\DOMNode $newnode, \DOMNode $referencenode, $clone = 0) {
1074 5
        if ($newnode->ownerDocument !== $referencenode->ownerDocument) {
1075 4
            $newnode = $referencenode->ownerDocument->importNode($newnode, true);
1076 4
        } else {
1077 2
            if ($clone > 0) {
1078
                $newnode = $newnode->cloneNode(true);
1079
            }
1080
        }
1081 5
        return $newnode;
1082
    }
1083
1084
    /**
1085
     * Checks whether the first node in the set is disconnected (has no parent node)
1086
     *
1087
     * @return bool
1088
     */
1089 1
    public function isDisconnected()
1090
    {
1091 1
        $parent = $this->getNode(0)->parentNode;
1092 1
        return ($parent == null || $parent->tagName == self::FRAGMENT_ROOT_TAGNAME);
1093
    }
1094
1095 1
    public function __get($name)
1096
    {
1097
        switch ($name) {
1098 1
            case 'count':
1099 1
            case 'length':
1100 1
                return count($this);
1101
        }
1102 1
        throw new \Exception('No such property ' . $name);
1103
    }
1104
}
1105