Sommaire
  1. Les balises qui structurent une page
  2. Ce que l'IA rend quand on lui demande une page
  3. Les quatre confusions les plus fréquentes
  4. Contrôler les balises d'une page générée
  5. Demander à l'IA un HTML qui a du sens
  6. Ce que la sémantique ne règle pas

Une balise HTML est un mot entre chevrons, comme <p> ou <nav>, qui dit au navigateur ce qu’est un morceau de contenu : un paragraphe, un menu, un titre, un bouton. La plupart vont par paires, une ouvrante et une fermante, et l’ensemble forme un élément. HTML en compte plus d’une centaine, mais une vingtaine suffit à structurer une page. C’est justement sur celles-là que le code généré par l’IA se trompe le plus : il affiche correctement, et il dit pourtant autre chose que ce qu’il montre.

Les balises qui structurent une page

Voici la liste courte, celle qu’on retrouve dans presque toutes les pages. Chaque ligne indique aussi la confusion la plus fréquente dans le code généré.

Balise Rôle Ce que l’IA confond
header En-tête de la page ou d’un article Un div nommé « header »
nav Bloc de navigation principal Posée sur chaque groupe de liens, pied de page compris
main Contenu principal, une seule fois par page Absente, ou répétée
article Contenu autonome : billet, fiche, commentaire Utilisée pour n’importe quel bloc
section Partie thématique, avec un titre Section sans titre, en guise de div
aside Contenu annexe Rarement utilisée
footer Pied de page ou d’article Un div nommé « footer »
h1 à h6 Titres, du plus général au plus précis Niveau choisi pour la taille du texte
button Action dans la page Un div avec onclick
a Lien vers une autre adresse Un lien href="#" qui déclenche une action
ul, ol, li Listes Une suite de div
strong, em Importance, insistance b et i, purement visuels
p, br Paragraphe, retour à la ligne br répété pour créer de l’espace

Les balises de l’en-tête du document (title, meta, link) et les balises de contenu comme img ou form ont leurs propres pièges, traités dans d’autres guides de la rubrique Intégration HTML et CSS.

Ce que l’IA rend quand on lui demande une page

Consigne donnée à un assistant de code : « Fais la page d’accueil d’une boulangerie en HTML et CSS, avec un menu, une présentation, trois produits phares et un bouton de commande. » La page s’affiche bien. Le squelette, lui, ressemble souvent à ceci :

index.html8 lignes retirées, 13 ajoutées
Retiré : <div class="header">Retiré :   <div class="menu"><a href="/">Accueil</a> <a href="/pains">Nos pains</a></div>Retiré : </div>Retiré : <div class="hero"><h3>La Fournée du Coin</h3></div>Retiré : <section class="produits">Retiré :   <article><h1>Baguette tradition</h1></article>Retiré : </section>Retiré : <div class="btn" onclick="commander()">Commander</div>Ajouté : <header>Ajouté :   <nav aria-label="Menu principal">Ajouté :     <ul><li><a href="/">Accueil</a></li><li><a href="/pains">Nos pains</a></li></ul>Ajouté :   </nav>Ajouté : </header>Ajouté : <main>Ajouté :   <h1>La Fournée du Coin</h1>Ajouté :   <section aria-labelledby="titre-produits">Ajouté :     <h2 id="titre-produits">Nos produits phares</h2>Ajouté :     <article><h3>Baguette tradition</h3></article>Ajouté :   </section>Ajouté :   <button type="button">Commander</button>Ajouté : </main>

Les deux versions sont identiques à l’écran une fois stylées. La différence est pour tout ce qui lit la page sans la voir : un lecteur d’écran ne trouve ni menu ni zone principale dans la première, les moteurs de recherche y lisent « Baguette tradition » comme titre principal, et le bouton n’est pas atteignable au clavier. Ce sont quatre confusions distinctes, détaillées ci-dessous.

Les quatre confusions les plus fréquentes

Le div à la place de la balise qui a un sens

Le div ne dit rien de son contenu : c’est une boîte neutre, utile pour la mise en page. Quand header, nav, main et footer sont remplacés par des div à classe, la page perd ses repères. Les lecteurs d’écran proposent de sauter directement au menu ou au contenu principal : ces raccourcis n’existent que si les balises sont là.

Le niveau de titre choisi pour sa taille

L’IA prend souvent un h3 parce qu’il « fait la bonne taille », ou met un h1 sur chaque carte produit. Or les titres forment le plan de la page : un seul sujet principal en h1, puis des h2 pour les grandes parties, des h3 à l’intérieur, sans sauter de niveau. La taille se règle en CSS, jamais en changeant de balise.

Le div cliquable à la place du button

C’est l’erreur la plus lourde de conséquences. Un button reçoit le focus au clavier, réagit à Entrée et à Espace, et il est annoncé comme un bouton. Un div avec onclick ne fait rien de tout cela. La règle de choix est simple : si l’élément mène à une autre adresse, c’est un lien a ; s’il déclenche une action dans la page, c’est un button. Ajouter un rôle ARIA au div ne règle que l’annonce, pas le clavier : voir quand l’ARIA ajouté par l’IA est de trop.

Section et article posés partout

L’excès inverse existe aussi : certains assistants remplacent chaque div par une section ou un article, pour « faire sémantique ». Une section regroupe une partie qui a son propre titre. Un article est un contenu qui garderait son sens publié seul ailleurs : un billet, une fiche produit, un commentaire. Un bloc qui sert seulement à aligner des éléments reste un div.

Contrôler les balises d’une page générée

  1. Le plan des titres. Une extension comme HeadingsMap affiche la liste des titres : elle doit se lire comme une table des matières, avec un seul h1 et sans saut de niveau.
  2. Les repères de la page. Dans Chrome, le panneau Accessibilité des outils de développement affiche l’arbre d’accessibilité : on doit y trouver une bannière, une navigation, une zone principale et des boutons là où l’on clique.
  3. Le clavier. Parcourir la page avec Tab : chaque élément cliquable doit recevoir le focus. Un élément qu’on peut cliquer mais pas atteindre trahit un div.
  4. Le validateur. Le validateur du W3C (validator.w3.org) signale les balises mal fermées, les imbrications interdites et les attributs inventés.

Ces vérifications recoupent plusieurs des critères WCAG que le code généré rate le plus.

Demander à l’IA un HTML qui a du sens

La consigne « utilise du HTML sémantique » produit souvent l’excès décrit plus haut : des section partout. Une consigne précise marche mieux :

  • « Structure la page avec header, nav, main et footer, une seule fois chacun. »
  • « Un seul h1, puis h2 et h3 sans sauter de niveau ; la taille des titres se règle en CSS. »
  • « Toute action est un button, toute navigation est un lien a avec une vraie adresse. »
  • « N’utilise section que pour une partie qui a un titre, sinon un div. »

Demandez ensuite à l’assistant de lister le plan des titres de sa propre page : les sauts de niveau apparaissent tout de suite. Pour relire le reste du code qu’il produit, HTML et CSS ensemble, voir lire ce que l’IA écrit en HTML et CSS.

Ce que la sémantique ne règle pas

De bonnes balises ne rendent pas une page accessible à elles seules : le contraste, les alternatives d’images, les formulaires et le comportement au clavier des composants restent à vérifier. Elles ne font pas non plus remonter une page dans les résultats de recherche par miracle : elles aident les moteurs à comprendre la structure, sans remplacer un contenu utile. Enfin, la frontière entre section, article et div prête à débat, même entre spécialistes. Mieux vaut un div honnête qu’une balise sémantique posée au hasard.

Questions fréquentes

Quels sont les différents types de balises ?

On distingue les balises de structure (header, nav, main, section, article, aside, footer), les balises de titre (h1 à h6), les balises de texte (p, strong, em, ul, ol, li), les balises interactives (a, button, input) et les balises de l’en-tête du document (title, meta, link). La plupart vont par paires, ouvrante et fermante ; certaines, comme br ou img, sont orphelines.

Comment utiliser les balises HTML ?

On place le contenu entre une balise ouvrante et une balise fermante, par exemple <p>texte</p>, et on choisit la balise selon le sens du contenu, pas selon son apparence. L’apparence se règle ensuite en CSS. Les balises s’imbriquent sans se chevaucher : la dernière ouverte est la première fermée.

Quelle est la balise qui permet de passer à la ligne ?

La balise br, qui n’a pas de balise fermante. Elle sert à un retour à la ligne à l’intérieur d’un même paragraphe, comme dans une adresse ou un poème. Pour séparer deux paragraphes, on utilise deux balises p, et pour créer de l’espace, une marge en CSS.

Quelle est la différence entre section et article ?

Un article est un contenu autonome, qui garderait son sens publié seul : un billet, une fiche produit, un commentaire. Une section regroupe une partie thématique d’un ensemble et porte un titre. Un article peut contenir des sections, et une section peut contenir des articles.

Faut-il un seul h1 par page ?

C’est la pratique recommandée : un h1 qui annonce le sujet de la page, puis des h2 et des h3 pour les parties, sans sauter de niveau. HTML n’interdit pas plusieurs h1, mais un seul titre principal rend le plan plus clair pour les lecteurs d’écran comme pour les moteurs de recherche.

Pourquoi utiliser button plutôt qu'une div cliquable ?

Parce que le button est atteignable au clavier, réagit aux touches Entrée et Espace et est annoncé comme un bouton par les lecteurs d’écran, sans une ligne de script. Une div cliquable ne fait rien de tout cela et bloque les personnes qui naviguent sans souris.