Aide-mémoire JavaScript --- Modifier les attributs et les classes CSS¶
Cette rubrique présente des méthodes qui permettent de modifier les attributs HTML et les classes d'un élément avec JavaScript.
Dans les exemples, on suppose que l'élément HTML a été récupéré dans une variable. Par exemple :
<img id="photo" src="images/chat.jpg" alt="Un chat">
let photo = document.getElementById("photo");
À retenir :
setAttribute,getAttributeetremoveAttributeagissent sur les attributs HTML. Les méthodes declassListservent à gérer les classes sans effacer les autres classes déjà présentes.
1. setAttribute("name", "value")¶
À quoi sert cette méthode ?¶
setAttribute() permet d'ajouter un attribut à une balise HTML ou de
modifier la valeur d'un attribut qui existe déjà.
"name": le nom de l'attribut à modifier."value": la valeur à donner à cet attribut.
Exemple¶
HTML avant JavaScript :
<img id="photo" src="images/chat.jpg" alt="Un chat">
JavaScript :
let photo = document.getElementById("photo");
photo.setAttribute("src", "images/chien.jpg");
photo.setAttribute("alt", "Un chien");
photo.setAttribute("onclick", "afficherDetails()");
HTML après JavaScript :
<img id="photo" src="images/chien.jpg" alt="Un chien" onclick="afficherDetails()">
La méthode a remplacé les valeurs des attributs src et alt. Elle
peut aussi créer un attribut qui n'existait pas :
photo.setAttribute("title", "Clique pour voir la photo");
L'élément possède alors un nouvel attribut title.
2. getAttribute("name")¶
À quoi sert cette méthode ?¶
getAttribute() permet de lire et de recevoir la valeur d'un attribut
HTML.
"name": le nom de l'attribut dont on veut connaître la valeur.- La méthode retourne la valeur de l'attribut sous forme de texte.
- Si l'attribut n'existe pas, elle retourne
null.
Exemple¶
HTML avant JavaScript :
<a id="lien" href="https://www.cegeplevis.ca">Visiter le cégep</a>
JavaScript :
let lien = document.getElementById("lien");
let adresse = lien.getAttribute("href");
alert(adresse);
Résultat affiché :
https://www.cegeplevis.ca
La page HTML ne change pas : JavaScript a simplement lu la valeur de
l'attribut href.
3. removeAttribute("name")¶
À quoi sert cette méthode ?¶
removeAttribute() permet de retirer complètement un attribut d'une
balise HTML.
"name": le nom de l'attribut à supprimer.- Si l'attribut n'existe pas, la méthode ne provoque pas d'erreur.
Exemple¶
HTML avant JavaScript :
<button type="button" id="bouton" disabled>Envoyer</button>
JavaScript :
let bouton = document.getElementById("bouton");
bouton.removeAttribute("disabled");
HTML après JavaScript :
<button type="button" id="bouton">Envoyer</button>
L'attribut disabled a été retiré. Le bouton n'est donc plus désactivé
et l'utilisateur peut cliquer dessus.
4. classList.add("name")¶
À quoi sert cette méthode ?¶
classList.add() permet d'ajouter une classe CSS à un élément HTML.
"name": le nom de la classe à ajouter, sans le point (.).- Les classes déjà présentes sont conservées.
- Si la classe est déjà présente, elle n'est pas ajoutée une deuxième fois.
Exemple¶
HTML avant JavaScript :
<p id="message" class="fg-primary">Bienvenue !</p>
JavaScript :
let message = document.getElementById("message");
message.classList.add("fs-3xl");
HTML après JavaScript :
<p id="message" class="fg-primary fs-3xl">Bienvenue !</p>
La classe fs-3xl a été ajoutée à la liste des classes de l'élément.
Les deux classes CSS peuvent maintenant contribuer à son apparence.
5. classList.remove("name")¶
À quoi sert cette méthode ?¶
classList.remove() permet de supprimer une classe CSS d'un élément
HTML, sans retirer les autres classes.
"name": le nom de la classe à supprimer, sans le point (.).- Si la classe n'existe pas, la méthode ne provoque pas d'erreur.
Exemple¶
HTML avant JavaScript :
<p id="message" class="fg-primary fs-3xl">Bienvenue !</p>
JavaScript :
let message = document.getElementById("message");
message.classList.remove("fg-primary");
HTML après JavaScript :
<p id="message" class="fs-3xl">Bienvenue !</p>
Seule la classe fg-primary a été retirée. La classe fs-3xl est
toujours présente.
6. classList.replace("old", "new")¶
À quoi sert cette méthode ?¶
classList.replace() permet de remplacer une classe CSS par une autre.
"old": le nom de la classe à remplacer."new": le nom de la nouvelle classe.- Les autres classes de l'élément sont conservées.
- Si la classe à remplacer n'existe pas, rien n'est modifié.
Exemple¶
HTML avant JavaScript :
<p id="message" class="fs-3xl fg-warning">Attention !</p>
JavaScript :
let message = document.getElementById("message");
message.classList.replace("fg-warning", "fg-success");
HTML après JavaScript :
<p id="message" class="fs-3xl fg-success">Attention !</p>
La classe fg-warning a été remplacée par la classe fg-success. La
classe fs-3xl est restée en place.
7. classList.toggle("name")¶
À quoi sert cette méthode ?¶
classList.toggle() permet d'ajouter ou de supprimer une classe CSS
selon qu'elle est déjà présente ou non.
- Si la classe est absente, elle est ajoutée.
- Si la classe est présente, elle est supprimée.
- La méthode retourne
truesi la classe est présente après l'opération etfalsesi elle est absente.
C'est particulièrement pratique pour créer un effet qui s'active et se désactive, par exemple afficher ou masquer un élément, ou changer son apparence au clic.
Exemple¶
HTML avant JavaScript :
<button type="button" id="bouton" onclick="soulignerTexte()">Changer l'apparence</button>
<p id="message" class="fs-3xl">Bonjour !</p>
JavaScript :
let message = document.getElementById("message");
message.classList.toggle("text-underline");
HTML après un premier clic :
<p id="message" class="fs-3xl text-underline">Bonjour !</p>
La classe text-underline a été ajoutée : le texte est souligné.
HTML après un deuxième clic :
<p id="message" class="fs-3xl">Bonjour !</p>
La classe text-underline a été retirée : le texte reprend son apparence
initiale. Chaque clic alterne entre les deux états.