CKTIS / HTML
dialog — une boîte de dialogue native
L’élément `dialog` représente une fenêtre temporaire permettant d’effectuer une tâche ou de présenter des informations. Sa méthode `show()` l’affiche de manière non modale, tandis que `showModal()` bloque les interactions avec le reste du document.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<dialog>…</dialog>
dialog.show();
dialog.showModal();
dialog.close(result);dialog est une fenêtre destinée à une brève interaction avec l’application, et non un substitut à un menu ou à une info-bulle. Les balises ouvrante et fermante sont toutes deux requises. Sans open, l’élément n’est pas affiché par défaut ; open seul ne rend pas la boîte de dialogue modale.
show() affiche une boîte de dialogue non modale. showModal() la place dans la couche supérieure ; le reste du document devient inactif (inert). L’élément doit être connecté au document. Appeler showModal() sur une boîte de dialogue déjà ouverte de manière non modale déclenche InvalidStateError.
Donnez-lui un nom explicite, par exemple avec aria-labelledby, ainsi qu’un bouton de fermeture visible. Définissez le focus initial avec autofocus sur un contrôle adapté. Ne définissez pas tabindex sur dialog.
close(result) ferme la boîte de dialogue, stocke la chaîne fournie dans returnValue et déclenche un événement close. requestClose(result) déclenche d’abord l’événement annulable cancel ; preventDefault() peut empêcher la fermeture. Ne supprimez pas manuellement open, car cela contourne le cycle de fermeture prévu. closedby contrôle la fermeture automatique : any autorise aussi les clics à l’extérieur, closerequest autorise les demandes de fermeture et none n’autorise ni l’un ni l’autre. Sans cet attribut, les boîtes modales prennent en charge les demandes de fermeture, contrairement aux boîtes non modales.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Dialog example</title>
<button id="launch" type="button">Open</button>
<dialog id="box" aria-labelledby="heading">
<h2 id="heading">Confirmation</h2>
<p>Close this dialog to continue.</p>
<button id="finish" type="button" autofocus>OK</button>
</dialog>
<p id="status" role="status">Ready</p>
<script>
const box = document.getElementById('box');
const status = document.getElementById('status');
document.getElementById('launch').addEventListener('click', () => {
box.returnValue = '';
box.showModal();
});
document.getElementById('finish').addEventListener('click', () => {
box.close('confirmed');
});
box.addEventListener('close', () => {
status.textContent = box.returnValue === 'confirmed'
? 'Result: confirmed'
: 'Result: dismissed';
});
</script>
</html>Résultat
Result: confirmed
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.