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

Où et comment insérer du JavaScript ?

Découvrez les différentes façons d'ajouter du JavaScript à une page HTML : script interne, fichier externe relié avec l'attribut src (méthode recommandée) et attributs d'événement à éviter. La leçon e...

0 chapitres 0 QCM Accès gratuit
Dans cet article

À propos de ce cours

Découvrez les différentes façons d'ajouter du JavaScript à une page HTML : script interne, fichier externe relié avec l'attribut src (méthode recommandée) et attributs d'événement à éviter. La leçon explique où placer la balise script, l'utilisation de defer, des modules et de noscript, l'ordre de chargement des bibliothèques et les erreurs d'intégration les plus fréquentes. Avec des exemples et des activités corrigées.
  1. Objectifs

    • Connaître les différentes façons d'ajouter du JavaScript à une page HTML.
    • Savoir lier un fichier externe avec le bon chemin.
    • Choisir l'emplacement de la balise <script> dans la page.
    • Éviter les erreurs les plus fréquentes d'intégration.
  2. La balise <script>

    • Le code JavaScript est placé dans une page grâce à la balise <script>. Elle peut contenir le code directement ou désigner un fichier avec l'attribut src.
    • En HTML5, l'attribut type="text/javascript" est inutile: JavaScript est le type par défaut. On n'écrit type que pour les modules (type="module").
    • Une page peut contenir plusieurs balises <script>; elles s'exécutent par défaut dans l'ordre où elles apparaissent.

    Trois façons d'insérer du JavaScript : fichier externe, script interne, attribut d'événement

  3. 1re méthode : le script interne

    • Le code est écrit directement entre <script> et </script>.
    <body>
      <h1>Bienvenue</h1>
      <script>
        console.log("Bonjour depuis un script interne");
      </script>
    </body>
    • Avantage: rapide pour un petit test.
    • Inconvénients: le code n'est pas réutilisable sur d'autres pages, il n'est pas mis en cache par le navigateur, et il mélange HTML et JavaScript.
  4. 2e méthode : le fichier externe (recommandée)

    • Le code est placé dans un fichier .js et relié avec l'attribut src:
    <head>
      <meta charset="UTF-8">
      <title>Ma page</title>
      <script src="js/app.js" defer></script>
    </head>
    // js/app.js : pas de balise <script> dans un fichier .js !
    console.log("Bonjour depuis un fichier externe");
    • Avantages: séparation claire HTML / CSS / JS, même fichier utilisable sur plusieurs pages, mise en cache par le navigateur (chargement plus rapide), code plus facile à maintenir.
    • Le chemin dans src peut être :
      • relatif: js/app.js (dossier js à côté de la page), ../js/app.js (on remonte d'un dossier) ;
      • absolu: https://cdn.jsdelivr.net/npm/bootstrap@5.3.9/dist/js/bootstrap.bundle.min.js (fichier sur un CDN).
    Piège : une balise <script src="..."> doit rester vide. Si on y écrit du code, il est ignoré. Il faut toujours écrire la balise fermante </script> (pas de <script />).
  5. 3e méthode : les attributs d'événement (à éviter)

  6. <button onclick="alert('Merci !')">Cliquez</button>
  • Cette écriture fonctionne encore, mais elle mélange le HTML et le JavaScript, ne permet qu'un gestionnaire par événement et pose des problèmes de sécurité (elle est bloquée par certaines politiques de sécurité, CSP).
  • La bonne pratique est d'écrire le comportement dans le fichier JavaScript avec addEventListener:
<button id="btnMerci">Cliquez</button>
// js/app.js
document.querySelector("#btnMerci").addEventListener("click", () => {
  alert("Merci !");
});
  • À proscrire aussi : les liens du type <a href="javascript:...">.
  1. Où placer la balise <script> ?

    • Le navigateur lit la page de haut en bas. Quand il rencontre un script classique, il s'arrête pour le télécharger et l'exécuter. Un script placé dans le <head> sans précaution s'exécute donc avant que les éléments du <body> existent :
    <head>
      <script>
        // ✘ Erreur : le h1 n'existe pas encore → null
        document.querySelector("h1").textContent = "Bonjour";
        // TypeError: Cannot set properties of null (setting 'textContent')
      </script>
    </head>
    <body>
      <h1>Titre</h1>
    </body>
    • Deux solutions correctes :
      1. Solution classique: placer les scripts juste avant </body>, quand tout le contenu est déjà chargé.
      2. Solution moderne (recommandée): placer le script dans le <head> avec l'attribut defer. Le fichier est téléchargé pendant la lecture de la page et exécuté une fois la page entièrement lue (voir la leçon suivante).
  2. Les modules et la balise <noscript>

    • <script type="module" src="js/main.js"></script> charge un module: il peut utiliser import et export, il est automatiquement en mode strict et se comporte comme defer. Les modules exigent un serveur (Live Server) : ils ne fonctionnent pas en file://.
    • <noscript> affiche un message aux visiteurs dont le JavaScript est désactivé :
    <noscript>
      <p>Cette application nécessite JavaScript. Veuillez l'activer.</p>
    </noscript>
  3. Ordre des scripts et bibliothèques

    • Si votre code utilise une bibliothèque (Bootstrap, par exemple), la bibliothèque doit être chargée avant votre fichier :
    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.9/dist/js/bootstrap.bundle.min.js" defer></script>
    <script src="js/app.js" defer></script> <!-- utilise bootstrap.Modal, bootstrap.Toast… -->
  4. Erreurs fréquentes

  5. SymptômeCause probable
    Rien ne se passe, la console affiche une erreur 404 (onglet Réseau)Chemin de src faux, faute de frappe ou de majuscule (App.js au lieu de app.js)
    Cannot read properties of nullLe script s'exécute avant que l'élément HTML existe : ajoutez defer ou déplacez le script
    Le code écrit dans <script src="...">...</script> ne s'exécute pasLe contenu d'une balise avec src est ignoré
    bootstrap is not definedLa bibliothèque est chargée après votre script, ou pas du tout
    Cannot use import statement outside a moduleIl manque type="module" sur la balise
  6. Activités

  7. Activité 1 : les trois méthodes

  • Créez une page avec trois boutons. Le premier affiche une alerte avec un attribut onclick, le deuxième avec un script interne et addEventListener, le troisième avec un fichier externe js/app.js.
  • Comparez la lisibilité des trois versions et notez vos conclusions dans le README.md.

Activité 2 : reproduire l'erreur

  • Placez un script qui modifie un titre dans le <head>, sans defer. Relevez le message d'erreur dans la console.
  • Corrigez-le de deux façons : en déplaçant le script avant </body>, puis en ajoutant defer.

Activité 3 : le chemin du fichier

  • Dans l'arborescence suivante, écrivez le bon src pour relier app.js depuis index.html, puis depuis pages/contact.html:
site/
├── index.html
├── pages/
│   └── contact.html
└── js/
    └── app.js

Activité 4 : trouver l'erreur

<script src="js/app.js">
  console.log("Démarrage");
</script>
  • Pourquoi « Démarrage » ne s'affiche-t-il jamais ? Proposez une correction. Déposez vos fichiers dans le dépôt GitHub js-integration.
Corrigés. Activité 3 : depuis index.html → js/app.js; depuis pages/contact.html → ../js/app.js. Activité 4 : le contenu d'une balise qui a un attribut src est ignoré. On écrit le console.log dans app.js, ou dans une deuxième balise <script> sans src.
  • À retenir

    • On privilégie un fichier externe relié par <script src="..."></script>.
    • On place le script dans le <head> avec defer, ou juste avant </body>.
    • On évite les attributs onclick et les liens javascript: au profit de addEventListener.
    • Les bibliothèques sont chargées avant le code qui les utilise.

    Sources : MDN Web Docs (developer.mozilla.org), documentation de Visual Studio Code et des Chrome DevTools.



  • Cet article vous a-t-il aidé ?