Aide-mémoire JavaScript --- Modifier le contenu HTML¶
Cette rubrique présente six méthodes qui permettent de créer, ajouter, retirer ou remplacer des éléments HTML avec JavaScript.
1. createElement() --- Créer un nouvel élément¶
À quoi ça sert ?
La méthode createElement() crée un nouvel élément HTML. L'élément est
créé en mémoire : il n'apparaît pas encore dans la page. Pour
l'afficher, il faut ensuite l'ajouter à l'aide d'une autre balise déjà présente dans la page.
Syntaxe :
let nouvelElement = document.createElement("balise");
Exemple : créer un paragraphe
JavaScript :
let nouveauParagraphe = document.createElement("p");
nouveauParagraphe.innerText = "Bienvenue sur ma page !";
À retenir : le HTML affiché dans le navigateur n'a pas changé.
Le nouveau paragraphe existe, mais il n'a pas encore été ajouté à la page. On doit utiliser appendChild() pour ajouter la nouvelle balise dans la page.
2. appendChild() --- Ajouter un élément dans un parent¶
À quoi ça sert ?
La méthode appendChild() ajoute un élément comme dernier enfant d'un
autre élément.
Syntaxe :
elementParent.appendChild(elementAAjouter);
Exemple : ajouter un paragraphe
HTML avant :
<div id="conteneur">
<p>Bonjour !</p>
</div>
JavaScript :
let nouveauParagraphe = document.createElement("p");
nouveauParagraphe.innerText = "Bienvenue sur ma page !";
let conteneur = document.getElementById("conteneur");
conteneur.appendChild(nouveauParagraphe);
HTML après :
<div id="conteneur">
<p>Bonjour !</p>
<p>Bienvenue sur ma page !</p>
</div>
À retenir : le nouvel élément est placé à la fin du parent.
3. removeChild() --- Retirer un élément enfant¶
À quoi ça sert ?
La méthode removeChild() retire un enfant précis de son élément
parent. Il faut donc retrouver le parent et l'élément à retirer.
Syntaxe :
elementParent.removeChild(elementARetirer);
Exemple : supprimer un paragraphe
HTML avant :
<div id="conteneur">
<p id="message1">Premier message</p>
<p id="message2">Deuxième message</p>
</div>
JavaScript :
let conteneur = document.getElementById("conteneur");
let message = document.getElementById("message1");
conteneur.removeChild(message);
HTML après :
<div id="conteneur">
<p id="message2">Deuxième message</p>
</div>
À retenir : removeChild() s'appelle sur le parent, et non sur
l'élément que l'on veut supprimer.
4. remove() --- Supprimer un élément HTML¶
À quoi ça sert ?
La méthode remove() permet de supprimer directement un élément HTML de la page.
Contrairement à removeChild(), il n'est pas nécessaire de retrouver son élément parent. On appelle simplement remove() sur l'élément que l'on souhaite supprimer.
Syntaxe :
element.remove();
Exemple : supprimer un paragraphe
HTML avant :
<div id="conteneur">
<p id="message1">Bonjour !</p>
<p id="message2">Bienvenue !</p>
</div>
Javascript :
let message = document.getElementById("message1");
message.remove();
HTML après :
<div id="conteneur">
<p id="message2">Bienvenue !</p>
</div>
À retenir: remove() supprime directement l'élément sélectionné, sans avoir besoin de connaître son parent.
5. replaceChild() --- Remplacer un élément par un autre¶
À quoi ça sert ?
La méthode replaceChild() remplace un enfant existant par un nouvel
élément. Elle reçoit deux paramètres : le nouvel élément, puis l'ancien
élément à remplacer.
Syntaxe :
elementParent.replaceChild(nouvelElement, ancienElement);
Exemple : remplacer un paragraphe
HTML avant :
<div id="conteneur">
<p id="ancien">Message original</p>
</div>
JavaScript :
let conteneur = document.getElementById("conteneur");
let ancienMessage = document.getElementById("ancien");
let nouveauMessage = document.createElement("p");
nouveauMessage.innerText = "Le message a été remplacé !";
nouveauMessage.id = "nouveau";
conteneur.replaceChild(nouveauMessage, ancienMessage);
HTML après :
<div id="conteneur">
<p id="nouveau">Le message a été remplacé !</p>
</div>
À retenir : l'ordre des paramètres est important : le nouvel élément en premier, l'ancien en deuxième.
6. insertBefore() --- Insérer un élément avant un autre¶
À quoi ça sert ?
La méthode insertBefore() ajoute un nouvel élément avant un enfant
déjà présent dans le même parent.
Syntaxe :
elementParent.insertBefore(nouvelElement, elementDeReference);
Exemple : insérer un paragraphe avant un autre
HTML avant :
<div id="conteneur">
<p id="message1">Premier message</p>
<p id="message2">Deuxième message</p>
</div>
JavaScript :
let conteneur = document.getElementById("conteneur");
let message2 = document.getElementById("message2");
let nouveauMessage = document.createElement("p");
nouveauMessage.innerText = "Message inséré";
conteneur.insertBefore(nouveauMessage, message2);
HTML après :
<div id="conteneur">
<p id="message1">Premier message</p>
<p>Message inséré</p>
<p id="message2">Deuxième message</p>
</div>
À retenir : le deuxième paramètre indique l'élément devant lequel le nouvel élément sera placé. Les deux éléments doivent être associés au même parent.
7. replaceChildren() --- Remplacer tous les enfants¶
À quoi ça sert ?
La méthode replaceChildren() remplace tous les enfants d'un élément
par le ou les éléments fournis. Si on l'appelle sans paramètre, elle
vide complètement le contenu de l'élément.
Syntaxe :
elementParent.replaceChildren(nouvelElement1, nouvelElement2);
Exemple : remplacer le contenu d'un conteneur
HTML avant :
<div id="conteneur">
<p>Ancien message 1</p>
<p>Ancien message 2</p>
</div>
JavaScript :
let conteneur = document.getElementById("conteneur");
let titre = document.createElement("h2");
titre.innerText = "Nouveau contenu";
let paragraphe = document.createElement("p");
paragraphe.innerText = "Voici le nouveau texte.";
conteneur.replaceChildren(titre, paragraphe);
HTML après :
<div id="conteneur">
<h2>Nouveau contenu</h2>
<p>Voici le nouveau texte.</p>
</div>
Pour vider complètement un conteneur :
let conteneur = document.getElementById("conteneur");
conteneur.replaceChildren();
Après cette instruction :
<div id="conteneur"></div>
À retenir : contrairement à replaceChild(), qui remplace un seul
enfant, replaceChildren() remplace tous les enfants du parent.
8. `cloneNode() --- Copier un élément HTML¶
À quoi ça sert ?
La méthode cloneNode() permet de créer une copie d'un élément HTML existant.
Elle peut copier uniquement l'élément lui-même ou copier également tous ses éléments enfants.
Syntaxe :
element.cloneNode(true);
- true : copie l'élément ainsi que tout son contenu (éléments enfants).
- false : copie uniquement l'élément, sans ses enfants. C'est la valeur par défaut.
Exemple :
HTML avant :
<div id="conteneur">
<div id="carte">
<h3>Pokémon</h3>
<p>Pikachu est un Pokémon électrique.</p>
</div>
</div>
Javascript :
let carte = document.getElementById("carte");
// Créer une copie de la carte et de son contenu
let copie = carte.cloneNode(true);
copie.id = "carte_copie";
// Ajouter la copie dans le conteneur
let conteneur = document.getElementById("conteneur");
conteneur.appendChild(copie);
HTML après :
<div id="conteneur">
<div id="carte">
<h3>Pokémon</h3>
<p>Pikachu est un Pokémon électrique.</p>
</div>
<div id="carte_copie">
<h3>Pokémon</h3>
<p>Pikachu est un Pokémon électrique.</p>
</div>
</div>
À retenir :
cloneNode(true)copie l'élément et tout son contenu.cloneNode(false)copie uniquement l'élément, sans son contenu.- La copie n'est pas automatiquement ajoutée à la page. Il faut utiliser une méthode comme
appendChild()pour l'insérer. - ⚠ Il faut modifier l'identifiant si les deux éléments doivent coexister dans la même page.
Petit conseil pour programmer¶
Pour ajouter un nouvel élément, on utilise souvent ces deux étapes :
- Créer l'élément avec
document.createElement(). - Lui donner du contenu, par exemple avec
innerText, puis l'ajouter avecappendChild()ouinsertBefore().
Exemple :
let nouveauItem = document.createElement("li");
nouveauItem.innerText = "Apprendre JavaScript";
let liste = document.getElementById("maListe");
liste.appendChild(nouveauItem);
Important : ces méthodes modifient le contenu de la page affichée dans le navigateur. Elles ne modifient pas directement le fichier HTML enregistré sur votre ordinateur.
Vérifier si une balise existe déjà¶
Pour éviter de dupliquer une balise ou de causer des problèmes en créant plus d'une balise avec le même id, il est préférable de valider que cette dernière n'existe pas déjà.
Comment ?
document.getElementById() retourne null si la balise n'a pas été trouvée.
Exemple :
let balise = document.getElementById("carteVisite");
if(balise == null) {
//La balise recherchée n'existe pas et on peut la créer
}