CKTIS / HTML
nomodule — un script classique pour les navigateurs sans modules
L’attribut booléen `nomodule` d’un élément `script` empêche l’exécution d’un script classique dans les navigateurs qui prennent en charge à la fois les modules JavaScript et cet attribut. Il permet de fournir une ancienne version du code à côté d’un script de module.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<script nomodule src="legacy.js"></script>nomodule s’applique aux scripts classiques, qu’ils soient intégrés au document ou externes. Un navigateur qui prend en charge à la fois les modules et nomodule n’exécute pas un script classique portant cet attribut. La prise en charge des modules ne suffit pas : Safari 10.1 prenait en charge les scripts de module, mais ne tenait pas compte de nomodule, si bien que les deux scripts pouvaient s’exécuter. Un navigateur ancien qui ne reconnaît ni les modules ni nomodule ignore l’attribut et exécute le script classique, mais n’exécute pas le script avec type="module", dont le type lui est inconnu.
Il s’agit d’un attribut booléen : sa présence signifie vrai et son absence signifie faux. Les formes valides comprennent nomodule, nomodule="" et nomodule="nomodule". Écrire nomodule="false" n’est pas conforme et laisse tout de même l’attribut présent ; pour le désactiver, supprimez l’attribut.
nomodule n’est pas un mécanisme de repli déclenché par une erreur du module. Si le module ne se charge pas ou déclenche une erreur, cela ne provoque pas l’exécution du script classique ignoré. Ne combinez pas nomodule avec type="module" : cet usage ne respecte pas les exigences pour les auteurs et n’empêche pas l’exécution du module.
L’exemple fournit deux variantes indépendantes qui définissent le texte du même élément. Avec JavaScript activé et la prise en charge des modules et de nomodule, le résultat attendu est module ; dans un navigateur ancien qui ne prend en charge aucun des deux mécanismes, c’est classic.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>nomodule demo</title>
<p id="result">pending</p>
<script type="module">
document.getElementById('result').textContent = 'module';
</script>
<script nomodule>
document.getElementById('result').textContent = 'classic';
</script>
</html>Résultat
module
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.