cours/docs/dev/02-intermediaire/javascript.md

142 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# JavaScript Intermédiare
Le JavaScript est un langage de programmation dont nous nous servirons pour rendre nos pages HTML/CSS dynamiques.
On l'écrit généralement en dehors du HTML, dans un fichier `main.js`. Afin de relier le JavaScript au HTML, il convient d'appeler le fichier via une balise `<script>`, positionnée avant la balise `<body>` fermante.
::: details
```html{3}
<body>
<script src="./js/main.js"></script>
</body>
```
:::
## Les types de données
Il existe en JavaScript plusieurs [types de données&nbsp;:](https://developer.mozilla.org/fr/docs/Web/JavaScript/Data_structures)
- Valeurs primitives&nbsp;:
- <span lang="en">Number</span> (nombre)
- <span lang="en">String</span> (chaîne de caractères)
- <span lang="en">Boolean</span> (booléen)
- <span lang="en">Null</span> (nul)
- <span lang="en">Undefined</span> (indéfini)
- <span lang="en">Object</span> (objet)
Il est possible de regrouper ces types de données dans des tableaux (<span lang="en">Array</span>).
## Sélectionner le document HTML ([DOM](https://developer.mozilla.org/fr/docs/Web/API/Document_Object_Model/Introduction))
JavaScript nous permet d'éxécuter des actions sur une page HTML. Par exemple&nbsp;:
- afficher, masquer, créer et supprimer des éléments&nbsp;;
- stocker, trier, organiser des données&nbsp;;
- modifier les styles CSS&nbsp;;
- ajouter des conditions, des boucles, des événements…
- etc.
Dans la plupart des cas, il est nécessaire de cibler un ou plusieurs éléments du document HTML afin de leur appliquer ces actions.
Afin de sélectionner un élément HTML en JavaScript, il faut utiliser une méthode permettant de cibler le ou les éléments qui nous intéressent. Il est possible de cibler un élément via le nom de sa balise, la valeur d'un attribut (`id` ou `classe` par exemple) ou d'autres moyens plus complexes que nous ne verrons pas ici.
### Sélectionner des balises
La méthode pour sélectionner une balise est la suivante&nbsp;:
<<< @/snippets/js/DOM-select.js#getElementsByTagName
Toutes les balises correspondantes sont retournées sous forme de `HTMLCollection` (un équivalent de tableau JavaScript).
### Sélectionner un id
<<< @/snippets/js/DOM-select.js#getElementById
Retourne un objet.
### Sélectionner une classe
<<< @/snippets/js/DOM-select.js#getElementsByClassName
Retourne un tableau.
::: warning Attention à l'orthographe
Notez que les méthodes qui retournent plusieurs éléments s'écrivent au pluriel alors que la sélection via un `id` est au singulier. Cela permet de se rappeler que la valeur d'un attribut `id` doit être unique dans la page HTML.
:::
### Sélectionner librement n'importe quoi
Il existe une méthode permettant de spécifier librement le type d'attribut à sélectionner. Il devient possible de chaîner ces attributs à la manière d'un sélecteur CSS.
<<< @/snippets/js/DOM-select.js#querySelector
Retourne un objet pour `querySelector` ou un `NodeList` pour `querySelectorAll` (semblable à un tableau).
## Les variables
Lorsque l'on sélectionne un élément, la valeur retournée n'est pas enregistrée par défaut. Si nous avons besoin de cibler à nouveau le même élément, il faudra alors réécrire toute la méthode de sélection.
Afin d'éviter de dupliquer du code inutilement, il est possible de stocker des données dans des variables afin de les réutiliser à plusieurs endroits.
On peut créer une variable de trois façons&nbsp;:
- [const](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Statements/const)
- [let](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Statements/let)
- [var](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Statements/var)
Retenez que `const` permet de déclarer une variable constante, c'est-à-dire qu'elle ne peut pas être réaffectée.
### Stocker des données
#### Une seule valeur
Il est recommandé de déclarer des variables dès que l'on a besoin de conserver une valeur.
<<< @/snippets/js/variables.js#const
On peut assigner directement des type de données dans une variable.
<<< @/snippets/js/variables.js#dataTypes
#### Plusieurs valeurs
Pour stocker plusieurs valeurs, il est possible de déclarer un object ou un tableau (en fonction de nos besoins).
<<< @/snippets/js/variables.js#multiplesValues
## Écouter des événements
Une fois nos éléments HTML ciblés et stockés, nous avons besoin de déclencher des actions lorsque quelque chose se passe. Ce quelque chose peut être un clic, un survol, un champ de formulaire qui change, etc.
Nous devons donc **écouter** ces événements déclencher ce qui doit l'être ensuite. La méthode JavaScript à utiliser est `addEventListener('ÉVÉNEMENT', FONCTION)`
<<< @/snippets/js/variables.js#addEventListener
## Les conditions
Il est souvent nécessaire de déclencher des actions sur la page uniquement si certaines conditions sont remplies. Par exemple, nous pouvons regarder la valeur vraie ou fausse d'une variable et déclencher ou non une action.
```js
if (condition) {
// code à exécuter
}
```
Si la condition est remplie, le code sera exécuté. Sinon, il sera ignoré.
Une condition se construit de cette façon&nbsp;:
`if` `(` `valeur à évaluer` `opérateur` `valeur de référence` `)`
Par exemple&nbsp;: `if` `(` `myName` `===` `'Nico'` `)` ou encore `if` `(` `myAge` `>` `18` `)`
Voici [une liste d'opérateurs](https://www.joshwcomeau.com/operator-lookup/) et leurs explications (en anglais).
### Évaluer un booléen
Un booléen peut être soit vrai soit faux. Pour évaluer sa valeur, nous pouvons nous contenter de renseigner le nom de la variable
<<< @/snippets/js/variables.js#conditionsIf