4.1 L'élément <dialog>
HTML5 a aussi introduit l'élément <dialog>, conçu pour créer des boîtes de dialogue et des fenêtres modales sur les pages web. Il permet de créer facilement, et de façon sémantiquement correcte, des fenêtres pop-up pour toutes sortes d'usages : notifications, confirmations, formulaires de saisie et bien plus encore. Plus bas, on va voir comment utiliser <dialog>, ses attributs et ses méthodes, ainsi que quelques exemples d'utilisation.
L'élément <dialog> représente une boîte de dialogue ou une autre fenêtre interactive. Il peut être modal ou non modal. À l'intérieur de <dialog>, tu peux placer n'importe quel contenu HTML : du texte, des formulaires, des boutons, etc.
Syntaxe :
<dialog>
<!-- Contenu de la boîte de dialogue -->
</dialog>
<div style="min-height: 200px;">
<dialog id="favSuperHeroDialog">
<form method="dialog">
<div>
<label for="favSuperHero">Super-héros préféré :</label>
<select id="favSuperHero" name="favSuperHero">
<option></option>
<option>Captain America</option>
<option>Iron Man</option>
<option>Hulk</option>
</select>
</div>
<div>
<button type="reset" id="cancel">Réinitialiser</button>
<button type="submit">Valider</button>
</div>
</form>
</dialog>
<button id="updateDetails">Ouvrir la boîte de dialogue</button>
</div>
<dialog id="favSuperHeroDialog">
<form method="dialog">
<div>
<label for="favSuperHero">Super-héros préféré :</label>
<select id="favSuperHero" name="favSuperHero">
<option></option>
<option>Captain America</option>
<option>Iron Man</option>
<option>Hulk</option>
</select>
</div>
<div>
<button type="reset" id="cancel">Réinitialiser</button>
<button type="submit">Valider</button>
</div>
</form>
</dialog>
<button id="updateDetails">Ouvrir la boîte de dialogue</button>
// On récupère les boutons et la boîte de dialogue dans le DOM
const updateButton = document.getElementById("updateDetails");
const cancelButton = document.getElementById("cancel");
const dialog = document.getElementById("favSuperHeroDialog");
// Fonction qui vérifie l'état de la boîte de dialogue (ouverte/fermée)
function openCheck(dialog) {
if (dialog.open) {
console.log("Dialogue ouvert");
} else {
console.log("Dialogue fermé");
}
}
// On ouvre la boîte de dialogue au clic sur le bouton Update
updateButton.addEventListener("click", () => {
dialog.showModal();
openCheck(dialog);
});
// On ferme la boîte de dialogue au clic sur le bouton Cancel
cancelButton.addEventListener("click", () => {
dialog.close();
openCheck(dialog);
});
4.2 Attributs et méthodes de <dialog>
L'attribut open indique si la boîte de dialogue est ouverte. Si cet attribut est présent, la boîte de dialogue s'affiche sur la page.
Exemple d'utilisation de l'attribut open :
<dialog open>
<p>Ceci est une boîte de dialogue ouverte.</p>
</dialog>
Une fenêtre affichée avec l'attribut open est toujours non modale. Pour ouvrir une fenêtre modale, on utilise la méthode showModal() (on en parle plus bas).
La propriété returnValue contient une chaîne de résultat : la valeur avec laquelle la fenêtre a été fermée. C'est une propriété de l'objet JavaScript de la boîte de dialogue, pas un attribut HTML, donc on ne l'écrit pas dans le balisage. La valeur est définie par la méthode close('valeur') ou par un bouton de formulaire avec method="dialog" — dans ce cas, returnValue reçoit la value du bouton cliqué. Si la fenêtre a été fermée avec la touche Échap, returnValue ne change pas.
dialog.close('confirm');
console.log(dialog.returnValue); // "confirm"
La méthode show() :
Ouvre la boîte de dialogue en mode non modal.
dialog.show();
La méthode showModal() :
Ouvre la boîte de dialogue en mode modal, en bloquant l'interaction avec le reste de la page.
dialog.showModal();
La méthode close() :
Ferme la boîte de dialogue.
dialog.close();
Comment « brancher » une méthode sur un bouton : le minimum de JavaScript
L'attribut open affiche la fenêtre dès le chargement de la page. Pour que la fenêtre s'ouvre et se ferme au clic sur un bouton, dans cette leçon on appelle les méthodes show(), showModal() et close() depuis JavaScript — ce sont justement elles dont tu auras besoin dans les exercices. On verra le langage en détail plus tard, pour l'instant ce modèle suffit :
<button id="btn-open">Afficher un indice</button>
<dialog id="info-dialog">
<p>Texte de la fenêtre</p>
<button id="btn-close">Compris</button>
</dialog>
<script>
// 1. On trouve les éléments de la page grâce à leur id
const openBtn = document.getElementById('btn-open');
const closeBtn = document.getElementById('btn-close');
const infoDialog = document.getElementById('info-dialog');
// 2. « Quand on clique sur le bouton, exécute le code entre les accolades »
openBtn.addEventListener('click', () => {
infoDialog.showModal(); // ouvrir en modal
});
closeBtn.addEventListener('click', () => {
infoDialog.close(); // fermer
});
</script>
- On place
<script>à la fin de<body>: le navigateur exécute un script dès qu'il l'atteint, et les éléments situés sous le script n'existent pas encore —getElementByIdrenverraitnull. document.getElementById('…')— « donne-moi l'élément qui a cet id ».element.addEventListener('click', () => { … })— « quand on clique sur l'élément, exécute le code entre les accolades ». La notation() => { … }est une fonction courte : du code qui s'exécutera plus tard, au clic.- Pour une fenêtre non modale, appelle
show()au lieu deshowModal().
4.3 Événements de <dialog>
L'événement close :
Événement déclenché à la fermeture de la boîte de dialogue.
<div style="min-height: 200px">
<dialog id="myDialog">
<form method="dialog">
<p>Clique sur "Annuler" ou "OK" pour renvoyer une valeur</p>
<div class="dialog-buttons">
<button value="cancel">Annuler</button>
<button value="confirm">OK</button>
</div>
</form>
</dialog>
<button id="showDialog">Afficher la boîte de dialogue</button>
</div>
<dialog id="myDialog">
<form method="dialog">
<p>Clique sur "Annuler" ou "OK" pour renvoyer une valeur</p>
<div class="dialog-buttons">
<button value="cancel">Annuler</button>
<button value="confirm">OK</button>
</div>
</form>
</dialog>
<button id="showDialog">Afficher la boîte de dialogue</button>
// On récupère les éléments du DOM
const dialog = document.getElementById('myDialog');
const showDialogButton = document.getElementById('showDialog');
// Ouverture de la fenêtre modale
showDialogButton.addEventListener('click', () => {
dialog.showModal();
});
// À la fermeture, on affiche returnValue
dialog.addEventListener('close', () => {
alert(`Dialogue fermé avec la valeur de retour : ${dialog.returnValue}`);
});
L'événement cancel :
Événement déclenché à l'annulation de la boîte de dialogue (par exemple, quand on appuie sur la touche Échap).
<div style="min-height: 200px">
<dialog id="myDialog">
<form method="dialog">
<p>Appuie sur la touche "Échap" pour voir le résultat</p>
</form>
</dialog>
<button id="showDialog">Ouvrir la boîte de dialogue</button>
</div>
<dialog id="myDialog">
<form method="dialog">
<p>Appuie sur la touche "Échap" pour voir le résultat</p>
</form>
</dialog>
<button id="showDialog">Ouvrir la boîte de dialogue</button>
// On récupère les éléments du DOM
const dialog = document.getElementById('myDialog');
const showDialogButton = document.getElementById('showDialog');
// Ouverture de la boîte de dialogue
showDialogButton.addEventListener("click", () => {
dialog.showModal();
});
// Gestion de l'annulation de la boîte de dialogue (touche Échap)
dialog.addEventListener('cancel', () => {
alert('Dialog was cancelled');
});
GO TO FULL VERSION