<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)
Exemple
#<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>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
#<dialog id="fenetre">
…
</dialog>Attributs
#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éthodesshow(),showModal()etclose()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éenLa 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.
<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>Plus d’exemples
#<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>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.
<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>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 :
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. SeuleshowModal()bloque le reste de la page et gère la touche Échap. - Donnez un nom à la fenêtre avec
aria-labelledbypointant vers son titre, pour que le lecteur d’écran annonce tout de suite de quoi elle traite. - Pour confirmer des actions irréversibles, placez
autofocussur le bouton sûr, par exemple « Annuler ».
Entrées associées
#- <form>Un formulaire qui collecte des données auprès de l’utilisateur et les envoie à une adresse donnée.
- <button>Un bouton cliquable : il envoie un formulaire, le réinitialise, ou lance une action sur la page.
- <details>Une section dépliable : le titre `<summary>` est toujours visible, et le reste du contenu apparaît au clic.
- <template>Un modèle HTML invisible qu’un script copie et insère dans la page.
Pratiquer dans les leçons
#Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.