<dialog>

Une boîte de dialogue ou fenêtre modale : confirmation, formulaire ou message affiché au-dessus du reste de la page.

Affichage
none (block une fois ouverte)
Balise fermante
Obligatoire
Contenu autorisé
Contenu de flux (flow content)
Sur cette page

Exemple

#
HTML
<button type="button" id="open-btn">Supprimer le projet</button>

<dialog id="confirm" aria-labelledby="confirm-title">
  <h2 id="confirm-title">Supprimer le projet « Carte de visite » ?</h2>
  <p>Cette action est irréversible.</p>
  <button type="button" id="cancel-btn" autofocus>Annuler</button>
  <button type="button" id="delete-btn">Supprimer</button>
</dialog>

<script>
  const dialog = document.getElementById('confirm')
  document.getElementById('open-btn').addEventListener('click', () => dialog.showModal())
  document.getElementById('cancel-btn').addEventListener('click', () => dialog.close())
  document.getElementById('delete-btn').addEventListener('click', () => dialog.close())
</script>
Aperçu

Définition et utilisation

#

L’élément <dialog> crée une boîte de dialogue. Elle est masquée par défaut, et vous l’ouvrez en JavaScript : la méthode showModal() l’affiche comme une fenêtre modale au-dessus de toute la page, avec un arrière-plan assombri, tandis que show() l’affiche comme une fenêtre ordinaire qui ne bloque pas le reste de la page. La méthode close() la ferme.

Une fenêtre modale ouverte avec showModal() fait le plus dur à votre place : elle déplace le focus dans la fenêtre, bloque l’interaction avec le reste de la page, se ferme avec la touche Échap et se place dans une couche au-dessus de tous les éléments (le top layer), donc inutile de vous battre avec z-index. Vous stylez l’arrière-plan derrière la fenêtre avec le pseudo-élément ::backdrop.

Un formulaire avec method="dialog" placé dans la fenêtre la ferme au clic sur un bouton et enregistre la value de ce bouton dans la propriété returnValue, ce qui vous permet de savoir ce que l’utilisateur a choisi. Depuis décembre 2025, on peut aussi ouvrir la fenêtre sans JavaScript, avec un bouton portant les attributs commandfor et command="show-modal".

Syntaxe

#
Syntaxe
<dialog id="fenetre">
  …
</dialog>

Attributs

#
  • open

    attribut booléen

    La fenêtre est visible. Un attribut écrit dans le code affiche la fenêtre en mode non modal, sans assombrissement et sans bloquer la page. Pour l’ouvrir et la fermer, utilisez les méthodes show(), showModal() et close() plutôt que d’ajouter ou de retirer cet attribut vous-même.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Attributs en pratique

#

open

attribut booléen

La fenêtre est visible. Un attribut écrit dans le code affiche la fenêtre en mode non modal, sans assombrissement et sans bloquer la page. Pour l’ouvrir et la fermer, utilisez les méthodes show(), showModal() et close() plutôt que d’ajouter ou de retirer cet attribut vous-même.

HTML
<dialog open>
  <p>Vous avez une leçon inachevée : <strong>Les listes en HTML</strong>.</p>
  <button type="button" onclick="this.closest('dialog').close()">Plus tard</button>
</dialog>
Aperçu

Plus d’exemples

#
Un formulaire avec method="dialog" et returnValue
HTML
<button type="button" id="rate-btn">Noter la leçon</button>
<p id="result"></p>

<dialog id="rate-dialog" aria-labelledby="rate-title">
  <form method="dialog">
    <h2 id="rate-title">Comment notez-vous la leçon ?</h2>
    <button value="faible">Faible</button>
    <button value="bien">Bien</button>
    <button value="excellent">Excellent</button>
  </form>
</dialog>

<script>
  const dialog = document.getElementById('rate-dialog')
  const result = document.getElementById('result')
  document.getElementById('rate-btn').addEventListener('click', () => {
    dialog.returnValue = ''
    dialog.showModal()
  })
  dialog.addEventListener('close', () => {
    result.textContent = dialog.returnValue ? 'Votre note : ' + dialog.returnValue : 'Fermé sans note'
  })
</script>
Aperçu

Chaque bouton d’un formulaire avec method="dialog" ferme la fenêtre et enregistre sa value dans dialog.returnValue. La touche Échap ferme la fenêtre sans modifier cette valeur.

Sans JavaScript : commandfor et command
HTML
<button type="button" commandfor="quiz-rules" command="show-modal">Règles du quiz</button>

<dialog id="quiz-rules" aria-labelledby="quiz-title">
  <h2 id="quiz-title">Règles du quiz</h2>
  <p>Vous avez 10 minutes pour répondre à 5 questions. Chacune a une seule bonne réponse.</p>
  <button type="button" commandfor="quiz-rules" command="close">Compris</button>
</dialog>
Aperçu

Les attributs commandfor et command fonctionnent dans tous les principaux navigateurs depuis décembre 2025. Dans les versions plus anciennes, le bouton ne fait rien.

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
dialog:not([open]) {
  display: none;
}
dialog {
  position: absolute;
  inset-inline: 0;
  width: fit-content;
  height: fit-content;
  margin: auto;
  border: solid;
  padding: 1em;
  background-color: Canvas;
  color: CanvasText;
}
dialog::backdrop {
  background: rgba(0, 0, 0, 0.1);
}

Compatibilité des navigateurs

#

Largement disponible · depuis 2022

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

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • N’ajoutez pas l’attribut open à la main si vous avez besoin d’une fenêtre modale. Seule showModal() bloque le reste de la page et gère la touche Échap.
  • Donnez un nom à la fenêtre avec aria-labelledby pointant vers son titre, pour que le lecteur d’écran annonce tout de suite de quoi elle traite.
  • Pour confirmer des actions irréversibles, placez autofocus sur le bouton sûr, par exemple « Annuler ».

Entrées associées

#

Pratiquer dans les leçons

#

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