Une boîte de dialogue modale est un type spécial de boîte de dialogue pop-up qui interrompt l'utilisateur sur une page Web. Bien qu'il existe des cas d'utilisation valides pour l'affichage d'une boîte de dialogue, vous devez réfléchir attentivement avant d'en ajouter une. Les boîtes de dialogue modales obligent les utilisateurs à se concentrer sur un contenu spécifique et à ignorer temporairement le reste de la page.
Les boîtes de dialogue peuvent être :
- Modale : les utilisateurs ne peuvent interagir qu'avec le contenu de la boîte de dialogue. Les boîtes de dialogue modales s'affichent au-dessus du contenu de la page. La page est définie sur inert et, par défaut, masquée par un arrière-plan semi-transparent.
- Non modale : les utilisateurs peuvent interagir avec le contenu en dehors de la boîte de dialogue.
L'élément HTML sémantique <dialog> permettant de créer une boîte de dialogue est fourni avec la sémantique, les interactions au clavier, ainsi que toutes les propriétés et méthodes de l'interface HTMLDialogElement.
Boîtes de dialogue modales
Voici un exemple de <dialog> modal. Cliquez sur Ouvrir la boîte de dialogue modale.
Une fois ouverte, la boîte de dialogue peut être fermée de trois manières : en appuyant sur la touche Échap, en envoyant un formulaire avec un bouton pour lequel l'attribut formmethod="dialog" est défini (ou si le formulaire lui-même est défini sur method="dialog") et en utilisant la méthode HTMLDialogElement.close().
HTMLDialogElement comporte trois méthodes principales, ainsi que toutes les méthodes héritées de HTMLElement.
dialog.show() /* opens the dialog */
dialog.showModal() /* opens the dialog as a modal */
dialog.close() /* closes the dialog */
Comme cet élément <dialog> a été ouvert avec la méthode HTMLDialogElement.showModal(), il s'agit d'une boîte de dialogue modale. L'ouverture d'une boîte de dialogue modale désactive et masque tout ce qui n'est pas la boîte de dialogue elle-même. Lorsque vous pointez sur l'UI en dehors de la boîte de dialogue, tous les éléments se comportent comme si pointer-events: none; était défini. Même le bouton qui ouvre la boîte de dialogue ne réagira pas aux interactions.
Lorsque la boîte de dialogue s'ouvre, le curseur est placé dessus. Le curseur est placé sur le premier élément de l'ordre de navigation séquentielle au clavier dans cette boîte de dialogue.
Si vous appuyez plusieurs fois sur la touche tab, seul le contenu de la boîte de dialogue peut être sélectionné tant que la fenêtre modale est ouverte. Tout ce qui se trouve en dehors de la boîte de dialogue reste inerte.
Lorsqu'une boîte de dialogue est fermée, qu'elle soit modale ou non, le curseur revient sur l'élément qui l'a ouverte. Évitez d'ouvrir une boîte de dialogue de manière programmatique sans action de l'utilisateur. Si vous devez le faire, assurez-vous de replacer le curseur là où il se trouvait avant l'ouverture de la boîte de dialogue, en particulier si l'utilisateur la ferme sans interagir avec elle.
Il existe un attribut global inert qui peut être utilisé pour désactiver un élément et tous ses descendants, à l'exception de toute boîte de dialogue active. Lorsqu'une boîte de dialogue modale est ouverte à l'aide de showModal(), l'inertie ou la désactivation se produit par défaut. L'attribut n'est pas explicitement défini.
L'arrière-plan qui masque tout ce qui n'est pas la boîte de dialogue peut être stylisé à l'aide du pseudo-élément ::backdrop. L'arrière-plan ne s'affiche que lorsqu'un <dialog> est affiché avec la méthode .showModal(). Ce pseudo-élément correspond à tous les arrière-plans, y compris celui qui s'affiche lorsque l'API FullScreen est utilisée, par exemple lorsque vous regardez une vidéo en mode plein écran qui n'a pas le même format que l'écran ou le moniteur.
Boîtes de dialogue non modales
HTMLDialogElement.show() ouvre également une boîte de dialogue, mais sans ajouter d'arrière-plan ni rendre quoi que ce soit inerte. La touche Échap ne ferme que les boîtes de dialogue modales, pas les boîtes de dialogue non modales. C'est pourquoi il est d'autant plus important d'inclure une méthode de fermeture de la boîte de dialogue non modale. Si l'option de fermeture se trouve en dehors de la boîte de dialogue, le curseur revient à l'élément qui a ouvert la boîte de dialogue. Cette expérience utilisateur n'est pas idéale.
Bien qu'un bouton permettant de fermer la boîte de dialogue ne soit pas officiellement requis par la spécification, considérez-le comme obligatoire. Un bouton visible pouvant recevoir la sélection améliore l'accessibilité et l'expérience utilisateur.
Fermer une boîte de dialogue
Vous n'avez pas besoin de la méthode HTMLDialogElement.close() pour fermer une boîte de dialogue. Vous n'avez pas du tout besoin de JavaScript. Pour fermer l'élément <dialog> sans JavaScript, incluez un formulaire avec une méthode de boîte de dialogue en définissant method="dialog" sur l'élément <form> ou formmethod="dialog" sur le bouton.
Lorsqu'un utilisateur envoie des données à l'aide de la méthode dialog, l'état des données saisies par l'utilisateur est conservé. Lorsqu'un événement d'envoi se produit, le formulaire est soumis à une validation des contraintes (sauf si novalidate est défini). Les données utilisateur ne sont ni effacées, ni envoyées. Vous pouvez créer un bouton de fermeture sans JavaScript :
<dialog open>
<form method="dialog">
<button type="submit" autofocus>close</button>
</form>
</dialog>
Vous avez peut-être remarqué l'attribut autofocus défini sur le bouton de fermeture <button> dans cet exemple. Les éléments dont l'attribut autofocus est défini dans un <dialog> ne sont sélectionnés au chargement de page que si la page a déjà été chargée avec la boîte de dialogue visible. Si la page n'a pas été chargée, ces éléments sont sélectionnés à l'ouverture de la boîte de dialogue.
Lorsqu'une boîte de dialogue est ouverte, le premier élément sélectionnable de la boîte de dialogue est sélectionné, sauf si un autre élément est défini avec l'attribut autofocus. Définir l'attribut autofocus sur le bouton de fermeture permet de s'assurer qu'il est sélectionné lorsque la boîte de dialogue est ouverte. Toutefois, l'inclusion de
autofocus dans un <dialog>
doit être mûrement réfléchie. Tous les éléments de la séquence précédant l'élément sélectionné automatiquement sont ignorés.
Nous aborderons cet attribut plus en détail dans le module sur le focus.
L'interface HTMLDialogElement inclut une propriété returnValue. L'envoi d'un formulaire avec un method="dialog" définit le returnValue sur le name, le cas échéant, du bouton d'envoi utilisé pour envoyer le formulaire. Si nous écrivions <button type="submit" name="toasty">close</button>, le returnValue serait toasty.
Lorsqu'une boîte de dialogue est ouverte, l'attribut booléen open est présent, ce qui signifie que la boîte de dialogue est active et qu'il est possible d'interagir avec elle.
Lorsqu'une boîte de dialogue est ouverte en ajoutant l'attribut open plutôt qu'avec .show() ou .showModal(), elle n'est pas modale. La propriété HTMLDialogElement.open renvoie true ou false, selon que la boîte de dialogue est disponible pour l'interaction, et non selon qu'elle est modale ou non.
Bien que JavaScript soit la méthode privilégiée pour ouvrir une boîte de dialogue, inclure l'attribut open au chargement de la page, puis le supprimer avec .close(), peut aider à s'assurer que la boîte de dialogue est disponible même lorsque JavaScript ne l'est pas.
Informations supplémentaires
Ne pas utiliser tabindex
L'élément activé pour ouvrir la boîte de dialogue et le bouton de fermeture qu'elle contient (et éventuellement d'autres contenus) peuvent recevoir le focus et sont interactifs. L'élément <dialog> n'est pas interactif et n'est pas sélectionné. N'ajoutez pas la propriété tabindex à la boîte de dialogue elle-même.
Rôles ARIA
Le rôle implicite est dialog.
Si la boîte de dialogue est une fenêtre de confirmation qui communique un message nécessitant une réponse ou une confirmation de l'utilisateur, définissez role="alertdialog".
Incluez un nom accessible pour la boîte de dialogue. Si le texte visible peut fournir le nom accessible, ajoutez aria-labelledby="idOfLabelingText".
Paramètres CSS par défaut
Les navigateurs fournissent un style par défaut pour dialog. Firefox, Chrome et Edge définissent color: CanvasText; et background-color: Canvas;. Safari définit color: black; background-color: white; dans ses feuilles de style user-agent.
color est hérité de dialog, au lieu de body ou :root, ce qui peut être inattendu. La propriété background-color n'est pas héritée.
Vérifiez vos connaissances
Testez vos connaissances sur l'élément dialog.
Comment styliser la zone derrière la boîte de dialogue ?
::background.::backdrop.background.