Aller au contenu

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, getAttribute et removeAttribute agissent sur les attributs HTML. Les méthodes de classList servent à 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 true si la classe est présente après l'opération et false si 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.