$nodes->append('!');
// Returns:
var_dump($doc->html());
```
---
## Methods
### Manipulation
#### addClass
```
self addClass(string|callable $class)
```
##### Example
```php
$doc = (new Document())->html('first paragraph
second paragraph
');
$doc->find('p')->addClass('text-center');
```
*Result:*
``` html
first paragraph
second paragraph
```
---
#### after
```
self after(string|NodeList|\DOMNode|callable $input)
```
##### Example
``` php
$doc = (new Document())->html('');
$doc->find('li')->after(' (after)');
```
*Result:*
``` html
- first (after)
- second (after)
```
---
#### append
```
self append(string|NodeList|\DOMNode|callable $input)
```
##### Example
``` php
$doc = (new Document())->html('The quick brown fox jumps over the lazy dog
');
$doc->find('div')->append(' Appended!');
```
*Result:*
``` html
The quick brown fox jumps over the lazy dog Appended!
```
---
#### appendTo
```
self appendTo(string|NodeList|\DOMNode $selector)
```
##### Example
``` php
$doc = (new Document())->html('The quick brown fox jumps over the lazy dog
');
$doc->create(' Appended!')->appendTo('div');
```
*Result:*
``` html
The quick brown fox jumps over the lazy dog Appended!
```
---
#### attr
```
self|string attr(string $name[, mixed $value = null])
```
##### Example #1 (Set)
``` php
$doc = (new Document())->html('');
$doc->attr('class', 'text-left');
```
*Result:*
``` html
```
##### Example #2 (Get)
``` php
$doc = (new Document())->html('');
echo $doc->attr('text-center');
```
*Result:*
``` html
text-center
```
---
#### before
```
self before(string|NodeList|\DOMNode|callable $input)
```
##### Example
``` php
$doc = (new Document())->html('');
$doc->find('li')->after('(before) ');
```
*Result:*
``` html
- (before) first
- (before) second
```
---
#### clone
```
NodeList|\DOMNode clone()
```
##### Example
``` php
$doc = (new Document())->html('');
$doc->find('div')->clone()->appendTo('ul');
```
*Result:*
``` html
```
---
#### detach
```
NodeList detach([string $selector = null])
```
##### Example
``` php
$doc = (new Document())->html('');
$el = $doc->find('ul.first li')->detach();
$doc->first('ul.second').append($el);
```
*Result:*
``` html
```
---
#### empty
```
self empty()
```
##### Example
``` php
$doc = (new Document())->html('The quick brown fox jumps over the lazy dog
');
$doc->find('div')->empty();
```
*Result:*
``` html
```
---
#### hasClass
```
bool hasClass(string $class)
```
##### Example
``` php
$doc = (new Document())->html('');
echo $doc->first('div')->hasClass('text-center');
```
*Result:*
``` html
true
```
---
#### html
```
string|self html([string|NodeList|\DOMNode|callable $input = null])
```
##### Example #1 (Set)
``` php
$doc = (new Document());
$doc->html('');
```
*Result:*
``` html
```
##### Example #1 (Get)
``` php
$doc = (new Document())->html('');
$doc->find('div')->append('Example!');
echo $doc->html();
```
*Result:*
``` html
Example!
```
---
#### prepend
```
self prepend(string|NodeList|\DOMNode|callable $input)
```
##### Example
``` php
$doc = (new Document())->html('The quick brown fox jumps over the lazy dog
');
$doc->find('div')->prepend('Prepended! ');
```
*Result:*
``` html
Prepended! The quick brown fox jumps over the lazy dog
```
---
#### prependTo
```
self prependTo(string|NodeList|\DOMNode $selector)
```
##### Example
``` php
$doc = (new Document())->html('The quick brown fox jumps over the lazy dog
');
$doc->create('Prepended! ')->appendTo('div');
```
*Result:*
``` html
Prepended! The quick brown fox jumps over the lazy dog
```
---
#### remove
```
self remove([string $selector = null])
```
##### Example
``` php
$doc = (new Document())->html('');
$doc->find('.first').remove();
```
*Result:*
``` html
```
---
#### removeAttr
```
self removeAttr(string $name)
```
##### Example
``` php
$doc = (new Document())->html('');
$doc->find('div').removeAttr('class');
```
*Result:*
``` html
```
---
#### removeClass
```
self removeClass(string|callable $class)
```
##### Example
``` php
$doc = (new Document())->html('');
$doc->find('div').removeClass('first');
```
*Result:*
``` html
```
---
#### replaceWith
```
self replaceWith(string|NodeList|\DOMNode|callable $input)
```
##### Example
``` php
```
---
#### text
```
string|self text([string|NodeList|\DOMNode|callable $input = null])
```
##### Example
``` php
```
---
#### unwrap
```
self unwrap()
```
##### Example
``` php
```
---
#### wrap
```
self wrap(string|NodeList|\DOMNode|callable $input)
```
##### Example
``` php
```
---
#### wrapAll
```
self wrapAll(string|NodeList|\DOMNode|callable $input)
```
##### Example
``` php
```
---
#### wrapInner
```
self wrapInner(string|NodeList|\DOMNode|callable $input)
```
##### Example
``` php
```
---
### Traversal
#### add
```
NodeList add(string|NodeList|\DOMNode $input)
```
Add additional node(s) to the existing set.
##### Example
``` php
$nodes = $doc->find('a');
$nodes->add($doc->find('p'));
```
---
#### children
```
NodeList children()
```
Return all children of each element node in the current set.
##### Example
``` php
$nodes = $doc->find('p');
$childrenOfParagraphs = $nodes->children();
```
---
#### closest
```
Element|NodeList|null closest(string|NodeList|\DOMNode|callable $input)
```
Return the first element matching the supplied input by traversing up through the ancestors of each node in the current set.
##### Example
``` php
$nodes = $doc->find('a');
$closestAncestors = $nodes->closest('p');
```
---
#### contents
```
NodeList contents()
```
Return all children of each node in the current set.
##### Example
``` php
$nodes = $doc->find('p');
$contents = $nodes->contents();
```
---
#### eq
```
\DOMNode|null eq(int $index)
```
Return node in the current set at the specified index.
##### Example
``` php
$nodes = $doc->find('a');
$nodeAtIndexOne = $nodes->eq(1);
```
---
#### filter
```
NodeList filter(string|NodeList|\DOMNode|callable $input)
```
Return nodes in the current set that match the input.
##### Example
``` php
$nodes = $doc->filter('a')
$exampleATags = $nodes->filter('[href*=https://example.org/]');
```
---
#### find
```
NodeList find(string $selector[, string $prefix = 'descendant::'])
```
Return the decendants of the current set filtered by the selector and optional XPath axes.
##### Example
``` php
$nodes = $doc->find('a');
```
---
#### first
```
mixed first()
```
Return the first node of the current set.
##### Example
``` php
$nodes = $doc->find('a');
$firstNode = $nodes->first();
```
---
#### has
```
NodeList has(string|NodeList|\DOMNode|callable $input)
```
Return nodes with decendants of the current set matching the input.
##### Example
``` php
$nodes = $doc->find('a');
$anchorTags = $nodes->has('span');
```
---
#### is
```
bool is(string|NodeList|\DOMNode|callable $input)
```
Test if nodes from the current set match the input.
##### Example
``` php
$nodes = $doc->find('a');
$isAnchor = $nodes->is('[anchor]');
```
---
#### last
```
mixed last()
```
Return the last node of the current set.
##### Example
``` php
$nodes = $doc->find('a');
$lastNode = $nodes->last();
```
---
#### map
```
NodeList map(callable $function)
```
Apply a callback to nodes in the current set and return a new NodeList.
##### Example
``` php
$nodes = $doc->find('a');
$nodeValues = $nodes->map(function($node) {
return $node->nodeValue;
});
```
---
#### following
```
\DOMNode|null following([string|NodeList|\DOMNode|callable $selector = null])
```
Return the sibling immediately following each element node in the current set.
*Optionally filtered by selector.*
##### Example
``` php
$nodes = $doc->find('a');
$follwingNodes = $nodes->following();
```
---
#### followingAll
```
NodeList followingAll([string|NodeList|\DOMNode|callable $selector = null])
```
Return all siblings following each element node in the current set.
*Optionally filtered by selector.*
##### Example
``` php
$nodes = $doc->find('a');
$follwingAllNodes = $nodes->followingAll('[anchor]');
```
---
#### followingUntil
```
NodeList followingUntil([[string|NodeList|\DOMNode|callable $input = null], string|NodeList|\DOMNode|callable $selector = null])
```
Return all siblings following each element node in the current set upto but not including the node matched by $input.
*Optionally filtered by input.*
*Optionally filtered by selector.*
##### Example
``` php
$nodes = $doc->find('a');
$follwingUntilNodes = $nodes->followingUntil('.submit');
```
---
#### not
```
NodeList not(string|NodeList|\DOMNode|callable $input)
```
Return element nodes from the current set not matching the input.
##### Example
``` php
$nodes = $doc->find('a');
$missingHrefAttribute = $nodes->not('[href]');
```
---
#### parent
```
Element|NodeList|null parent([string|NodeList|\DOMNode|callable $selector = null])
```
Return the immediate parent of each element node in the current set.
*Optionally filtered by selector.*
##### Example
``` php
$nodes = $doc->find('a');
$parentNodes = $nodes->parent();
```
---
#### parents
```
NodeList parent([string $selector = null])
```
Return the ancestors of each element node in the current set.
*Optionally filtered by selector.*
##### Example
``` php
$nodes = $doc->find('a');
$ancestorDivNodes = $nodes->parents('div');
```
---
#### parentsUntil
```
NodeList parentsUntil([[string|NodeList|\DOMNode|callable $input, [string|NodeList|\DOMNode|callable $selector = null])
```
Return the ancestors of each element node in the current set upto but not including the node matched by $selector.
*Optionally filtered by input.*
*Optionally filtered by selector.*
##### Example
``` php
$nodes = $doc->find('a');
$ancestorDivNodes = $nodes->parentsUntil('div');
```
---
#### preceding
```
\DOMNode|null preceding([string|NodeList|\DOMNode|callable $selector = null])
```
Return the sibling immediately preceding each element node in the current set.
*Optionally filtered by selector.*
##### Example
``` php
$nodes = $doc->find('a');
$precedingNodes = $nodes->preceding();
```
---
#### precedingAll
```
NodeList precedingAll([string|NodeList|\DOMNode|callable $selector = null])
```
Return all siblings preceding each element node in the current set.
*Optionally filtered by selector.*
##### Example
``` php
$nodes = $doc->find('a');
$precedingAllNodes = $nodes->precedingAll('[anchor]');
```
---
#### precedingUntil
```
NodeList precedingUntil([[string|NodeList|\DOMNode|callable $input = null], string|NodeList|\DOMNode|callable $selector = null])
```
Return all siblings preceding each element node in the current set upto but not including the node matched by $input.
*Optionally filtered by input.*
*Optionally filtered by selector.*
##### Example
``` php
$nodes = $doc->find('a');
$precedingUntilNodes = $nodes->precedingUntil('.submit');
```
---
#### siblings
```
NodeList siblings([[string|NodeList|\DOMNode|callable $selector = null])
```
Return siblings of each element node in the current set.
*Optionally filtered by selector.*
##### Example
``` php
$nodes = $doc->find('p');
$siblings = $nodes->siblings();
```
---
#### slice
```
NodeList slice(int $start[, int $end])
```
Return a subset of the current set based on the start and end indexes.
##### Example
``` php
$nodes = $doc->find('p');
// Return nodes 1 through to 3 as a new NodeList
$slicedNodes = $nodes->slice(1, 3);
```
---
### Additional Methods
#### count
```
int count()
```
##### Example
``` php
$nodes = $doc->find('p');
echo $nodes->count();
```
---
#### each
```
self each(callable $function)
```
##### Example
``` php
$nodes = $doc->find('p');
$nodes->each(function($node){
echo $node->nodeName . "\n";
});
```