---
gitea: none

include_toc: true

---

[TOC]

# Sélectionner des éléments HTML

- Sélectionner un élément à partir d'un sélecteur CSS :
  
  ```javascript
  document.querySelector($CSS_SELECTOR) // retourne un noeud ou undefined.
  ```

- Sélectionner tous les éléments à partir d'un sélecteur CSS :
  
  ```javascript
  document.querySelectorAll($CSS_SELECTOR) // retourne une liste
  ```

- Sélectionner un élément descendant de `$ELEM` à partir d'un sélecteur CSS :
  
  ```javascript
  $ELEM.querySelector($CSS_SELECTOR) // retourne un noeud ou undefined.
  ```

- Sélectionner un élément ancestre de `$ELEM` à partir d'un sélecteur CSS :
  
  ```javascript
  $ELEM.closest($CSS_SELECTOR) // retourne un noeud ou undefined.
  ```

- Est-ce que `$ELEM` correspond au sélecteur CSS ?
  
  ```javascript
  $ELEM.matches($CSS_SELECTOR) // retourne un booléen.
  ```



💡 En Typescript, vous pouvez préciser le type de retour :

```typescript
document.querySelector<HTMLDivElement>($CSS_SELECTOR) // retourne un DIV
```