<!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
Exemple
#<!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
#<!DOCTYPE html>Plus d’exemples
#<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>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.
<!-- 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.htmlvide 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, tapezdocument.compatModedans la console. Le résultatBackCompatsignale une déclaration manquante ou mal placée.
Entrées associées
#- <html>La racine d’un document HTML. Tous les autres éléments de la page se trouvent à l’intérieur.
- <head>La partie invisible du document qui contient les métadonnées : le titre, l’encodage des caractères, la description, les styles et les scripts.
- <meta>Les métadonnées de la page : encodage, affichage sur mobile, description pour les moteurs de recherche et aperçu du lien sur les réseaux sociaux.
- <!-- … -->Un commentaire dans le code HTML : une note pour les humains que le navigateur n’affiche pas, bien que chacun puisse la voir dans le code source de la page.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.