Sans cette ligne, certains navigateurs basculent silencieusement dans un mode dit « quirks », hérité des années 1990, qui reproduit d’anciens comportements incohérents pour ne pas casser de très vieilles pages web. Autant dire une source de bugs difficiles à diagnostiquer sur un site moderne.
Une seule forme à retenir
Contrairement aux anciennes versions de HTML qui imposaient une chaîne complexe référençant une définition de type de document, HTML5 a radicalement simplifié cette déclaration :
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="UTF-8">
</head>
<body>
</body>
</html>Tous les gabarits fournis par un thème WordPress démarrent par cette même ligne, générée dans le fichier header.php ou, pour les thèmes à blocs, dans le fichier de gabarit racine géré par le système FSE.
Bon à savoir
- Le doctype n’est ni sensible à la casse ni suivi d’un attribut de fermeture ; il ne s’agit d’ailleurs pas techniquement d’une balise HTML mais d’une instruction destinée au moteur de rendu.
- Un doctype absent ou mal placé, par exemple précédé d’un espace ou d’un commentaire, peut suffire à faire basculer la page en mode quirks.
- Le mode quirks affecte notamment le calcul des dimensions des boîtes CSS, ce qui peut expliquer des mises en page qui se comportent différemment d’un navigateur à un autre sans raison apparente.
- Un document sans doctype reste parfaitement valide du point de vue du navigateur qui l’affiche quand même, mais un validateur HTML le signalera systématiquement comme une erreur de conformité.