ꦫꦣꦺꦤ꧀ꦄꦤ꧀ꦠꦱꦺꦤ

PATH: home / carfac / .trash / wp-optimize / vendor / simplehtmldom / simplehtmldom / docs / HtmlNode

```php
find (
    string $selector
    [, int $idx = null ]
    [, bool $lowercase = false ]
) : mixed
```

| Parameter   | Description                                                |
|-------------|------------------------------------------------------------|
| `selector`  | [CSS](https://www.w3.org/TR/selectors/) selector.          |
| `idx`       | Index of element to return.                                |
| `lowercase` | Matches tag names case insensitive (lowercase) if enabled. |

Finds one or more nodes in the current document, using CSS selectors.

* Returns null if no match was found.
* Returns an array of [`HtmlNode`](index.md) if `$idx` is null.
* Returns an object of type [`HtmlNode`](index.md) if `$idx` is anything __but__ null.

## Supported Selectors

| Selector                           | Description                                                                                    |
|------------------------------------|------------------------------------------------------------------------------------------------|
| `*`                                | [Universal selector](https://www.w3.org/TR/selectors/#the-universal-selector)                  |
| `E`                                | [Type (tag name) selector](https://www.w3.org/TR/selectors/#type-selectors)                    |
| `E#id`                             | [ID selector](https://www.w3.org/TR/selectors/#id-selectors)                                   |
| `E.class`                          | [Class selector](https://www.w3.org/TR/selectors/#class-html)                                  |
| `E[attr]`                          | [Attribute selector](https://www.w3.org/TR/selectors/#attribute-selectors)                     |
| `E[attr="value"]`                  | [Attribute selector](https://www.w3.org/TR/selectors/#attribute-selectors)                     |
| `E[attr="value"] i`                | [Case-sensitivity](https://www.w3.org/TR/selectors/#attribute-case)                            |
| `E[attr="value"] s`                | [Case-sensitivity](https://www.w3.org/TR/selectors/#attribute-case)                            |
| `E[attr~="value"]`                 | [Attribute selector](https://www.w3.org/TR/selectors/#attribute-selectors)                     |
| `E[attr^="value"]`                 | [Substring matching attribute selector](https://www.w3.org/TR/selectors/#attribute-substrings) |
| `E[attr$="value"]`                 | [Substring matching attribute selector](https://www.w3.org/TR/selectors/#attribute-substrings) |
| `E[attr*="value"]`                 | [Substring matching attribute selector](https://www.w3.org/TR/selectors/#attribute-substrings) |
| <code>E[attr&#124;="value"]</code> | [Attribute selector](https://www.w3.org/TR/selectors/#attribute-selectors)                     | 
| `E F`                              | [Descendant combinator](https://www.w3.org/TR/selectors/#descendant-combinators)               |
| `E > F`                            | [Child combinator](https://www.w3.org/TR/selectors/#child-combinators)                         |
| `E + F`                            | [Next-sibling combinator](https://www.w3.org/TR/selectors/#adjacent-sibling-combinators)       |
| `E ~ F`                            | [Subsequent-sibling combinator](https://www.w3.org/TR/selectors/#general-sibling-combinators)  |
| `E, F`                             | [Selector list](https://www.w3.org/TR/selectors/#selector-list)                                |
| `E:not(s)`                         | [Negation pseudo-class](https://www.w3.org/TR/selectors-3/#negation)                           |

[-] getElementByTagName.md [edit]
[-] dump_node.md [edit]
[-] addClass.md [edit]
[-] __construct.md [edit]
[-] getElementsByTagName.md [edit]
[-] hasAttribute.md [edit]
[-] nodeName.md [edit]
[-] innertext.md [edit]
[-] getElementsById.md [edit]
[-] hasChildNodes.md [edit]
[-] index.md [edit]
[-] __set.md [edit]
[-] getAttribute.md [edit]
[-] makeup.md [edit]
[-] get_display_size.md [edit]
[-] find_ancestor_tag.md [edit]
[-] __destruct.md [edit]
[-] setAttribute.md [edit]
[-] is_utf8.md [edit]
[-] parentNode.md [edit]
[-] childNodes.md [edit]
[-] getAllAttributes.md [edit]
[-] text.md [edit]
[-] definitions.md [edit]
[-] firstChild.md [edit]
[-] clear.md [edit]
[-] removeChild.md [edit]
[-] previousSibling.md [edit]
[-] parent.md [edit]
[-] outertext.md [edit]
[-] is_block_element.md [edit]
[-] lastChild.md [edit]
[-] nextSibling.md [edit]
[-] xmltext.md [edit]
[-] removeAttribute.md [edit]
[-] getElementById.md [edit]
[-] remove.md [edit]
[-] parse_selector.md [edit]
[-] convert_text.md [edit]
[-] find.md [edit]
[-] __unset.md [edit]
[-] __call.md [edit]
[-] removeClass.md [edit]
[-] __toString.md [edit]
[-] __get.md [edit]
[-] __debugInfo.md [edit]
[-] expect.md [edit]
[-] save.md [edit]
[+] ..
[-] appendChild.md [edit]
[-] dump.md [edit]
[-] __isset.md [edit]
[-] seek.md [edit]
[-] match.md [edit]
[-] hasClass.md [edit]