Déclaration HTMLStructure du document

<!DOCTYPE html>

La déclaration du type de document sur la première ligne du fichier. Elle indique au navigateur d’afficher la page en mode standard plutôt qu’en mode de compatibilité.

Affichage
none (non affiché)
Contenu autorisé
Aucun. C’est une déclaration unique, sans contenu et sans balise fermante
Sur cette page

Exemple

#
HTML
<!DOCTYPE html>
<html lang="fr">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Leçon 1 : la première page | CodeWorlds</title>
  </head>
  <body>
    <h1>Ma première page</h1>
  </body>
</html>

Définition et utilisation

#

L’écriture <!DOCTYPE html> est la déclaration du type de document, ou doctype en abrégé. Ce n’est ni un élément ni une balise : elle n’a ni attributs ni balise fermante et n’affiche rien. Elle a une seule mission : indiquer au navigateur que le fichier est un document HTML moderne, à afficher selon les standards actuels.

Les navigateurs ont deux principaux modes d’affichage. En mode standard (standards mode), ils appliquent les règles actuelles de HTML et de CSS. En mode de compatibilité (quirks mode), ils imitent les erreurs des navigateurs d’il y a plus de vingt ans pour que de très vieilles pages aient l’apparence d’autrefois : les tableaux n’héritent pas de la taille de police, les hauteurs en pourcentage se calculent autrement, et le CSS accepte même des longueurs sans unité, comme width: 200. Le mode de compatibilité s’active justement quand la déclaration manque.

La déclaration doit se trouver tout au début du fichier, avant la balise <html>. Avant elle, le navigateur ne tolère que des espaces et des commentaires. S’il tombe d’abord sur un texte ou une balise quelconque, par exemple un message d’erreur écrit par le code du serveur, il considère qu’il n’y a pas de déclaration et fait passer la page en mode de compatibilité. La casse n’a pas d’importance, donc <!doctype html> fonctionne de la même façon.

Les anciennes versions de HTML et de XHTML utilisaient de longues déclarations avec un identifiant et l’adresse d’une définition de type de document (DTD). Les navigateurs ne téléchargeaient pas ces fichiers, ils reconnaissaient seulement la chaîne et choisissaient le mode en conséquence. Certaines anciennes déclarations activent le mode presque standard (almost standards), qui ne diffère du mode standard que par la façon de calculer la hauteur des lignes, ce qui se voit surtout avec les images dans les cellules de tableau. Sur les nouvelles pages, utilisez uniquement le court <!DOCTYPE html>.

Syntaxe

#
Syntaxe
<!DOCTYPE html>

Plus d’exemples

#
Vérifier le mode du document en JavaScript
HTML
<p>Cet aperçu fonctionne en mode : <strong id="current"></strong></p>
<p>Document avec la déclaration : <strong id="with-doctype"></strong></p>
<p>Document sans la déclaration : <strong id="without-doctype"></strong></p>

<script>
  const parser = new DOMParser();
  const withDoctype = parser.parseFromString('<!DOCTYPE html><p>Salut</p>', 'text/html');
  const withoutDoctype = parser.parseFromString('<p>Salut</p>', 'text/html');

  document.getElementById('current').textContent = document.compatMode;
  document.getElementById('with-doctype').textContent = withDoctype.compatMode;
  document.getElementById('without-doctype').textContent = withoutDoctype.compatMode;
</script>
Aperçu

La propriété document.compatMode renvoie BackCompat en mode de compatibilité et CSS1Compat dans les autres cas. DOMParser crée en mémoire deux documents invisibles qui ne diffèrent que par la déclaration, et cela suffit pour qu’ils fonctionnent dans des modes différents.

Des déclarations d’anciennes versions de HTML
HTML
<!-- HTML 4.01 Strict : mode standard -->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
  "http://www.w3.org/TR/html4/strict.dtd">

<!-- XHTML 1.0 Transitional : mode presque standard -->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<!-- HTML5 et suivants : ceci suffit -->
<!DOCTYPE html>

Vous croiserez de telles déclarations dans de vieux modèles et de vieux cours. Elles fonctionnent toujours, mais dans du nouveau code, remplacez-les par le court <!DOCTYPE html>.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Dans VS Code, tapez le caractère ! dans un fichier .html vide et appuyez sur Tab. Emmet insérera tout le squelette du document avec la déclaration.
  • Si la mise en page se comporte bizarrement, par exemple si height: 100% fonctionne autrement que dans les tutoriels ou si le texte des tableaux a la mauvaise taille, tapez document.compatMode dans la console. Le résultat BackCompat signale une déclaration manquante ou mal placée.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.