Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
JavaScript

Modifier le contenu et les attributs (textContent, innerHTML, dataset)

Modifier le contenu et les attributs (textContent, innerHTML, dataset). Dans cette leçon du cours JavaScript, vous apprendrez à : lire et modifier le texte d'un élément avec textContent ; savoir quand...

0 chapitres 0 QCM Accès gratuit
Dans cet article

À propos de ce cours

Modifier le contenu et les attributs (textContent, innerHTML, dataset). Dans cette leçon du cours JavaScript, vous apprendrez à : lire et modifier le texte d'un élément avec textContent ; savoir quand utiliser innerHTML, et ses dangers ; lire et modifier les attributs, et distinguer attribut et propriété ; stocker des données dans les attributs data-* avec dataset.

Chapitre 12 — Le DOM : parcours et mise à jour · Modifier le contenu et les attributs (textContent, innerHTML, dataset)

🎯 Objectifs de la leçon
• lire et modifier le texte d'un élément avec textContent;
• savoir quand utiliser innerHTML, et ses dangers ;
• lire et modifier les attributs, et distinguer attribut et propriété ;
• stocker des données dans les attributs data-* avec dataset.

1. Le contenu : textContent, innerText, innerHTML

textContent, innerText et innerHTML
Figure 1 — Trois façons de lire le contenu d'un élément.

📄 l6_contenu.html

<!DOCTYPE html>
<html lang="fr">
<head><meta charset="UTF-8"><link rel="stylesheet" href="style.css"></head>
<body>
  <div class="carte" id="fiche" data-id="42" data-niveau-requis="débutant">
    <h3 id="titre">Titre initial</h3>
    <p id="texte">Un texte <strong>important</strong><span class="cache"> caché</span>.</p>
    <a id="lien" href="/cours">Voir le cours</a>
    <p><img id="photo" src="plage-mini.svg" alt="" width="120"></p>
    <input id="champ" value="valeur de départ">
  </div>
  <pre id="sortie"></pre>

  <script>
    const $ = (s) => document.querySelector(s);
    const lignes = [];

    // 1. Lire le contenu
    const texte = $("#texte");
    lignes.push(`textContent = ${JSON.stringify(texte.textContent)}`);
    lignes.push(`innerText   = ${JSON.stringify(texte.innerText)}   (texte visible seulement)`);
    lignes.push(`innerHTML   = ${JSON.stringify(texte.innerHTML)}`);

    // 2. Modifier le contenu
    $("#titre").textContent = "Le DOM <en pratique>";      // affiché tel quel
    texte.innerHTML = "Un texte <em>modifié</em> par JavaScript.";  // balises interprétées

    // 3. Les attributs
    const lien = $("#lien");
    lignes.push("");
    lignes.push(`lien.getAttribute("href") = ${lien.getAttribute("href")}`);
    lignes.push(`lien.href                  = ${lien.href}`);
    lien.setAttribute("target", "_blank");
    lignes.push(`hasAttribute("target") ? ${lien.hasAttribute("target")}`);
    $("#photo").setAttribute("alt", "Une plage");
    $("#photo").src = "plage-mini.svg";

    // 4. Attribut ou propriété ? L'exemple du champ
    const champ = $("#champ");
    champ.value = "nouvelle valeur";
    lignes.push("");
    lignes.push(`champ.value               = ${champ.value}`);
    lignes.push(`champ.getAttribute("value") = ${champ.getAttribute("value")}`);

    // 5. Les attributs data-*
    const fiche = $("#fiche");
    lignes.push("");
    lignes.push(`fiche.dataset.id            = ${fiche.dataset.id} (${typeof fiche.dataset.id})`);
    lignes.push(`fiche.dataset.niveauRequis  = ${fiche.dataset.niveauRequis}`);
    fiche.dataset.vues = 128;
    lignes.push(`Après dataset.vues = 128 : data-vues="${fiche.getAttribute("data-vues")}"`);
    fiche.removeAttribute("data-niveau-requis");
    lignes.push(`Après removeAttribute : ${JSON.stringify({ ...fiche.dataset })}`);

    $("#sortie").textContent = lignes.join("\n");
  </script>
</body>
</html>

La page après les modifications, et les valeurs lues
La page après les modifications, et les valeurs lues

  • textContent renvoie tout le texte, même celui qui est caché par le CSS. En écriture, le texte est affiché tel quel: le titre affiche littéralement « Le DOM <en pratique> ».
  • innerText renvoie le texte visible, tel qu'il apparaît à l'écran ; il oblige le navigateur à calculer la mise en page, donc il est plus lent.
  • innerHTML renvoie ou remplace le code HTML intérieur : les balises écrites sont interprétées (« modifié » s'affiche en italique).
⚠️ Attention
N'utilisez jamais innerHTML avec un texte venu de l'utilisateur (champ de formulaire, adresse, données d'une API) : un visiteur malveillant pourrait y glisser du code (faille XSS, leçon 23.1). Pour afficher un texte, utilisez textContent; pour construire des éléments, utilisez createElement (leçon 12.8).

2. Les attributs

Attributs, propriétés, dataset et classList
Figure 2 — Les outils pour les attributs (classList est traitée à la leçon suivante).

  • getAttribute(nom): la valeur de l'attribut, telle qu'écrite dans le HTML (ou null) ;
  • setAttribute(nom, valeur): ajoute ou modifie l'attribut ;
  • hasAttribute(nom): teste sa présence ; removeAttribute(nom): le supprime.

La plupart des attributs standard existent aussi comme propriétés de l'élément : lien.href, img.src, img.alt, el.id, champ.value, caseACocher.checked. Attention aux différences :

  • lien.getAttribute("href") vaut "/cours" (ce qui est écrit), mais lien.href donne l'adresse complète calculée par le navigateur (dans l'exemple, celle du serveur local).
  • Pour un champ, l'attribut value est la valeur de départ; la propriété value est la valeur actuelle. Après modification, getAttribute("value") renvoie toujours « valeur de départ ».
  • L'attribut class correspond à la propriété className (car class est un mot réservé de JavaScript).

3. Les attributs data-* et dataset

Les attributs qui commencent par data- sont faits pour stocker vos propres données dans le HTML (un identifiant, une catégorie, un prix…). On les lit et les écrit avec element.dataset, en camelCase: data-niveau-requis devient dataset.niveauRequis. Les valeurs sont toujours des chaînes: dataset.id vaut "42", pas le nombre 42 (utilisez Number()).

ℹ️ À retenir
• textContent pour lire et écrire du texte ; innerHTML seulement pour du HTML que vous avez écrit vous-même.
• getAttribute, setAttribute, hasAttribute, removeAttribute pour les attributs.
• Propriété = valeur actuelle (champ.value, lien.href complet) ; attribut = valeur écrite dans le HTML.
• data-mon-info ↔ dataset.monInfo, toujours sous forme de texte.

🛠 Activité 6 — La fiche produit

Mission : Réalisez une fiche produit (nom, prix, image, description, lien « acheter ») dont le contenu est rempli par JavaScript à partir d'un objet.

Questions pour avancer (répondez dans votre compte rendu, puis appliquez dans votre projet) :

  1. Partez d'un objet { nom, prix, image, description, stock }. Remplissez le nom et le prix avec textContent. Comment affichez-vous le prix au format « 129,90 DH » ?
  2. Mettez à jour l'image : quels attributs devez-vous modifier pour qu'elle soit accessible ? Utilisez-vous setAttribute ou les propriétés ?
  3. La description contient un mot à mettre en gras. Proposez une solution avec innerHTML, puis expliquez pourquoi elle deviendrait dangereuse si la description venait d'un formulaire rempli par un vendeur.
  4. Stockez l'identifiant du produit et son stock dans des attributs data-. Lisez le stock avec dataset et affichez « Rupture » s'il vaut 0. Pourquoi dataset.stock === 0 ne fonctionne-t-il pas ?
  5. Si le produit est en rupture, désactivez le lien « acheter » : retirez son attribut href et ajoutez aria-disabled="true". Que devient l'apparence du lien sans href?
  6. Ajoutez un champ quantité. Modifiez sa valeur à la main, puis comparez champ.value et champ.getAttribute("value"). Expliquez la différence.

Je vérifie / je rends :

  • ☐ La fiche produit et les réponses aux questions 3, 4 et 6.

← Parcourir l'arbre du DOM : parents, enfants et frèresModifier les styles et les classes CSS (classList) →

Cet article vous a-t-il aidé ?