Web et développement

Comment créer des boîtes de dialogue modales accessibles avec HTML, CSS et JavaScript

How to Create Accessible Modal Dialogs with HTML, CSS, and JavaScript

Créez des boîtes de dialogue modales accessibles en utilisant l'élément natif dialog HTML. Apprenez à ouvrir et fermer des popups, gérer le focus clavier, styliser les arrière-plans, et créer des boîtes de dialogue de confirmation sans bibliothèque JavaScript.

Un visiteur clique sur un bouton de votre site web. Une fenêtre contextuelle apparaît avec un formulaire, un message de confirmation ou des informations supplémentaires.

Créer la fenêtre contextuelle visuelle est facile. La faire fonctionner correctement avec un clavier, un lecteur d'écran et un navigateur mobile est une autre affaire.

De nombreuses implémentations personnalisées de fenêtres modales reposent sur une grande quantité de JavaScript pour gérer le focus, bloquer l'interaction avec la page et gérer la touche Échap.

Le HTML moderne offre une approche plus simple : l'élément natif <dialog>.

Il fournit une grande partie du comportement attendu d'une boîte de dialogue modale directement dans le navigateur. Vous pouvez créer une fenêtre contextuelle fonctionnelle avec une petite quantité de HTML, de CSS et de JavaScript, sans installer de framework ni de plugin.

Dans ce tutoriel, nous allons créer une fenêtre modale réutilisable, la styliser, ajouter une boîte de dialogue de confirmation et explorer les détails d'accessibilité qui comptent dans les sites web réels.

1. Qu'est-ce qui différencie une boîte de dialogue modale d'une fenêtre contextuelle ordinaire ?

Une boîte de dialogue modale demande temporairement au visiteur d'interagir avec une partie particulière de l'interface avant de revenir à la page principale.

Les exemples typiques incluent :

  • Confirmer la suppression d'un élément.
  • Afficher un formulaire de contact.
  • Demander une confirmation avant de quitter une page.
  • Afficher des informations supplémentaires sur un produit.
  • Modifier un paramètre d'application.

Une fenêtre modale correctement implémentée doit rendre son objectif clair, offrir un moyen évident de la fermer et gérer correctement le focus clavier.

L'élément natif <dialog> prend en charge les comportements modal et non modal.

Méthode Comportement
showModal() Ouvre une fenêtre modale et rend le reste du document inerte
show() Ouvre une boîte de dialogue non modale
close() Ferme la boîte de dialogue
method="dialog" Permet à un bouton de formulaire de fermer la boîte de dialogue

Le comportement modal comprend la gestion du focus et l'interaction au clavier fournies par le navigateur.

2. Créez votre première fenêtre modale HTML

Commençons par un exemple simple : un bouton qui ouvre une boîte de dialogue contenant un titre, du texte et un bouton de fermeture.

<button type="button" id="openDialog">
    View delivery information
</button>

<dialog id="deliveryDialog"
        aria-labelledby="deliveryTitle">

    <h2 id="deliveryTitle">
        Delivery information
    </h2>

    <p>
        Orders are prepared within two business days.
        You will receive a tracking link by email.
    </p>

    <form method="dialog">
        <button type="submit" autofocus>
            Close
        </button>
    </form>

</dialog>

<script>
const openButton = document.getElementById('openDialog');
const dialog = document.getElementById('deliveryDialog');

openButton.addEventListener('click', () => {
    dialog.showModal();
});
</script>

Cela suffit pour créer une boîte de dialogue modale fonctionnelle.

Lorsque le visiteur clique sur le bouton, showModal() ouvre la boîte de dialogue au-dessus du contenu de la page.

Le navigateur gère automatiquement plusieurs comportements importants :

  • La boîte de dialogue entre dans la couche supérieure, au-dessus du contenu ordinaire de la page.
  • Le reste du document devient inerte.
  • Le focus clavier se déplace dans la boîte de dialogue.
  • Appuyer sur Échap la ferme normalement.
  • Le focus revient normalement au bouton d'ouverture lorsque la boîte de dialogue se ferme.

Le bouton de fermeture utilise method="dialog", il ne nécessite donc pas de gestionnaire d'événement JavaScript.

3. Stylisez la boîte de dialogue avec CSS

La boîte de dialogue par défaut fonctionne, mais son apparence est basique.

Nous pouvons lui donner des coins arrondis, un espacement confortable, une largeur responsive et un arrière-plan.

dialog {
    width: min(90vw, 520px);
    max-height: 85vh;
    box-sizing: border-box;
    padding: 2rem;
    border: 0;
    border-radius: 14px;
    background: #fff;
    color: #20242b;
    box-shadow: 0 20px 70px rgba(0, 0, 0, .2);
    overflow: auto;
}

dialog::backdrop {
    background: rgba(15, 23, 42, .65);
    backdrop-filter: blur(3px);
}

dialog h2 {
    margin-top: 0;
    font-size: 1.5rem;
}

dialog p {
    line-height: 1.6;
}

dialog button {
    padding: .75rem 1.25rem;
    border: 0;
    border-radius: 8px;
    background: #2458d3;
    color: #fff;
    font: inherit;
    cursor: pointer;
}

dialog button:focus-visible {
    outline: 3px solid #f59e0b;
    outline-offset: 3px;
}

Le pseudo-élément ::backdrop stylise la couche derrière une boîte de dialogue modale.

Il n'apparaît que lorsque la boîte de dialogue est affichée de manière modale, par exemple via showModal().

Une boîte de dialogue ouverte avec show() ne reçoit pas automatiquement le même comportement d'arrière-plan modal.

Pourquoi utiliser la couche supérieure ?

Les fenêtres contextuelles personnalisées traditionnelles reposent souvent sur des valeurs z-index de plus en plus grandes.

Une boîte de dialogue modale ouverte avec showModal() entre dans la couche supérieure du navigateur, ce qui évite de nombreux problèmes de contextes d'empilement.

C'est particulièrement utile sur les sites web contenant des en-têtes collants, des widgets flottants et des constructeurs de pages complexes.

4. Comprendre l'accessibilité au clavier

Une fenêtre modale doit fonctionner sans souris.

Imaginez un visiteur naviguant sur votre site web à l'aide de la touche Tab. Lorsqu'une fenêtre modale s'ouvre, il doit pouvoir interagir avec ses contrôles sans passer accidentellement dans la page située derrière.

La boîte de dialogue modale native contribue à ce comportement.

Le W3C décrit l'élément HTML dialog comme une technique pour créer des boîtes de dialogue modales accessibles, incluant le confinement du focus et le retour du focus lorsque la boîte de dialogue se ferme.

Donnez un nom accessible à la boîte de dialogue

Utilisez un titre visible et référencez-le avec aria-labelledby :

<dialog aria-labelledby="settingsTitle">
    <h2 id="settingsTitle">Account settings</h2>
    ...
</dialog>

Cela donne aux technologies d'assistance un nom significatif pour la boîte de dialogue.

Choisissez soigneusement le focus initial

L'attribut autofocus peut identifier le contrôle qui doit recevoir le focus lorsque la fenêtre modale s'ouvre.

Pour une boîte de dialogue informative, focaliser le bouton de fermeture peut être approprié.

Illustration of the article's main concept

Pour un formulaire, focaliser le premier champ peut avoir plus de sens.

Pour une confirmation destructive, focaliser l'action la plus sûre, comme Annuler, est souvent préférable.

Évitez de placer tabindex directement sur l'élément <dialog> ; la spécification HTML interdit cet attribut sur l'élément lui-même.

Fournissez toujours un bouton de fermeture visible

Même si Échap ferme normalement une boîte de dialogue modale, un contrôle de fermeture visible reste essentiel.

Les visiteurs mobiles peuvent ne pas avoir de clavier physique, et certains utilisateurs ne sauront pas qu'Échap peut fermer une fenêtre contextuelle.

5. Créez une boîte de dialogue de confirmation avec deux boutons

Construisons maintenant un exemple plus utile : confirmer la suppression d'un élément enregistré.

Le visiteur doit pouvoir choisir Annuler ou Supprimer.

HTML fournit un mécanisme pratique via method="dialog" et la propriété returnValue de la boîte de dialogue.

<button type="button" id="deleteItem">
    Delete item
</button>

<dialog id="confirmDialog"
        aria-labelledby="confirmTitle">

    <h2 id="confirmTitle">
        Delete this item?
    </h2>

    <p>
        This action cannot be undone.
    </p>

    <form method="dialog">
        <button value="cancel" autofocus>
            Cancel
        </button>

        <button value="confirm">
            Delete
        </button>
    </form>

</dialog>

<script>
const deleteButton = document.getElementById('deleteItem');
const confirmDialog = document.getElementById('confirmDialog');

deleteButton.addEventListener('click', () => {
    confirmDialog.returnValue = 'cancel';
    confirmDialog.showModal();
});

confirmDialog.addEventListener('close', () => {
    if (confirmDialog.returnValue === 'confirm') {
        // Call your application deletion logic here.
        console.log('Deletion confirmed');
    }
});
</script>

Le détail important est que cliquer sur un bouton à l'intérieur d'un formulaire method="dialog" ferme la boîte de dialogue et définit sa propriété returnValue.

Notre code vérifie si l'utilisateur a sélectionné confirm.

Réinitialiser la valeur avant l'ouverture évite qu'une confirmation antérieure soit prise pour une nouvelle si l'utilisateur ferme la boîte de dialogue avec Échap.

L'exemple ne supprime intentionnellement rien. Dans une application réelle, l'action confirmée appellerait votre propre point de terminaison PHP ou contrôleur d'application, avec les autorisations nécessaires et les protections CSRF.

6. Testez le flux de confirmation

Une démonstration utile est une liste d'éléments enregistrés, chacun avec un bouton Supprimer. Cliquer sur Supprimer doit ouvrir une boîte de dialogue de confirmation. Annuler doit laisser l'élément intact ; Confirmer doit supprimer uniquement l'élément sélectionné.

Cela illustre le flux de confirmation sans modifier les données réelles du site web.

7. Ajoutez un formulaire de contact dans une boîte de dialogue

Un formulaire de contact est un autre cas d'utilisation courant.

Mais il existe une différence importante entre fermer une boîte de dialogue et envoyer des données à un serveur.

Un formulaire avec method="dialog" ferme la fenêtre contextuelle. Il n'envoie pas de requête HTTP conventionnelle à votre backend PHP.

Pour un véritable formulaire de contact, utilisez une soumission de formulaire normale ou une requête AJAX.

Par exemple :

<dialog id="contactDialog"
        aria-labelledby="contactTitle">

    <h2 id="contactTitle">
        Contact us
    </h2>

    <form action="/contact-handler.php" method="post">
        <label for="contactEmail">
            Your email
        </label>

        <input
            type="email"
            id="contactEmail"
            name="email"
            required
            autocomplete="email"
            autofocus
        >

        <label for="contactMessage">
            Your message
        </label>

        <textarea
            id="contactMessage"
            name="message"
            required
        ></textarea>

        <button type="submit">
            Send message
        </button>

        <button type="button" id="closeContact">
            Cancel
        </button>
    </form>
</dialog>

Le bouton Envoyer soumet normalement le formulaire.

Le bouton Annuler doit fermer la boîte de dialogue sans soumettre :

document.getElementById('closeContact')
    .addEventListener('click', () => {
        document.getElementById('contactDialog').close();
    });

Votre gestionnaire PHP doit toujours valider les données soumises, mettre en œuvre une protection anti-spam et renvoyer une réponse de succès ou d'erreur significative.

Une boîte de dialogue modale améliore l'interface ; elle ne remplace pas la sécurité des formulaires côté serveur.

8. Les utilisateurs peuvent-ils fermer la boîte de dialogue en cliquant à l'extérieur ?

De nombreux sites web permettent aux visiteurs de fermer une fenêtre contextuelle en cliquant sur son arrière-plan.

Ce comportement est souvent appelé light dismiss.

Le HTML moderne inclut l'attribut closedby, qui peut spécifier si une boîte de dialogue peut être fermée par une interaction extérieure, des demandes de fermeture de la plateforme ou des contrôles explicites.

Par exemple :

<dialog id="infoDialog" closedby="any">
    <h2>More information</h2>
    <p>Additional details appear here.</p>

    <form method="dialog">
        <button>Close</button>
    </form>
</dialog>

La valeur closedby="any" permet le comportement de light dismiss dans les navigateurs qui le prennent en charge.

Cependant, la prise en charge des fonctionnalités plus récentes de dialog doit être vérifiée par rapport à vos navigateurs cibles. Les API de base showModal() et close() sont plus largement établies.

Pour les boîtes de dialogue de confirmation critiques, une fermeture accidentelle par l'extérieur peut être indésirable.

Dans tous les cas, conservez un contrôle visible de fermeture ou d'annulation.

9. Évitez ces erreurs d'implémentation courantes

Technical workflow illustration

Ouvrir une fenêtre modale en ajoutant l'attribut open

Ce code :

dialog.setAttribute('open', '');

ne fournit pas le même comportement que :

dialog.showModal();

L'attribut open affiche la boîte de dialogue de manière non modale. Il ne rend pas automatiquement le reste du document inerte.

Utilisez showModal() lorsque vous avez besoin d'une véritable fenêtre modale.

Supprimer l'attribut open pour fermer une fenêtre modale

Évitez de supprimer manuellement l'attribut open d'une fenêtre modale active.

Utilisez :

dialog.close();

Cela suit le cycle de vie prévu et garantit le comportement de fermeture approprié.

Utiliser un lien au lieu d'un bouton

Un contrôle qui ouvre une action d'interface doit généralement être un bouton :

<button type="button">Open settings</button>

Utilisez des liens pour la navigation vers une autre ressource.

Oublier la visibilité du focus

Les utilisateurs naviguant au clavier ont besoin d'une indication visible du contrôle actif.

Conservez un style :focus-visible clair plutôt que de supprimer les contours de focus du navigateur sans remplacement.

Placer la boîte de dialogue dans un conteneur masqué

Si un conteneur parent est masqué, ou si un CMS remplace dynamiquement le balisage environnant, la boîte de dialogue peut se comporter de manière inattendue.

Pour les intégrations de constructeurs de pages, préférez un conteneur stable et assurez-vous que le JavaScript s'exécute après l'insertion de la boîte de dialogue dans le document.

10. Intégrez une boîte de dialogue dans WordPress ou Joomla

Vous n'avez pas besoin de créer une extension uniquement pour utiliser l'élément dialog natif.

Pour un site web simple, l'intégration se compose de trois parties :

Partie Où elle va
Balisage HTML Bloc HTML personnalisé, module, modèle ou élément de constructeur de pages
CSS CSS personnalisé du thème ou du modèle
JavaScript JavaScript personnalisé du thème/modèle ou fonctionnalité prise en charge d'injection de code

WordPress

Dans WordPress, vous pouvez placer le HTML dans un bloc HTML personnalisé, à condition que votre compte et la configuration de l'éditeur autorisent le balisage nécessaire.

Ajoutez le style via le mécanisme de CSS personnalisé pris en charge par votre thème.

Pour le JavaScript, utilisez une zone de script prise en charge par le thème, un thème enfant ou une extension réputée d'insertion de code qui gère correctement le JavaScript.

Certains éditeurs et configurations de sécurité filtrent les éléments <script>. Ne partez pas du principe que le JavaScript collé directement dans un bloc de contenu s'exécutera.

Joomla

Dans Joomla, un module personnalisé ou un éditeur qui autorise un balisage HTML approprié peut contenir la boîte de dialogue.

Ajoutez le CSS à la feuille de style personnalisée de votre modèle, comme user.css dans un site basé sur Cassiopeia.

Placez le JavaScript à l'emplacement de script personnalisé pris en charge par le modèle ou via une extension appropriée.

Selon l'éditeur et les filtres de texte configurés, Joomla peut supprimer certains éléments ou attributs lors de l'enregistrement du contenu.

Si votre balisage disparaît, inspectez la configuration de l'éditeur et du filtrage plutôt que de coller répétitivement le même code.

Constructeurs de pages

Le même principe s'applique aux constructeurs de pages visuels : utilisez leurs capacités d'intégration HTML, CSS et JavaScript.

Pour le contenu chargé dynamiquement, initialisez les écouteurs d'événements uniquement après l'existence des éléments concernés.

Si une page contient plusieurs boîtes de dialogue, donnez à chacune un ID unique.

11. Testez votre fenêtre modale avant de publier

Une boîte de dialogue qui semble correcte sur ordinateur peut encore présenter des problèmes d'utilisabilité.

Testez-la avec une souris, un clavier et un appareil mobile.

Test Résultat attendu
Cliquer sur le bouton d'ouverture La boîte de dialogue apparaît
Appuyer sur Tab Le focus reste dans les contrôles de la fenêtre modale
Appuyer sur Maj + Tab La navigation inverse au clavier fonctionne
Appuyer sur Échap La boîte de dialogue se ferme lorsque cela est permis
Cliquer sur Fermer ou Annuler La boîte de dialogue se ferme
Fermer la boîte de dialogue Le focus revient de manière appropriée
Ouvrir sur mobile Le contenu reste lisible et défilable
Soumettre un formulaire invalide Le retour de validation est visible
Soumettre un formulaire valide L'application gère correctement les données
Utiliser un lecteur d'écran La boîte de dialogue a un nom compréhensible

La technique WCAG H102 du W3C fournit des conseils utiles pour valider le comportement modal natif.

12. Quand devez-vous utiliser une boîte de dialogue au lieu d'un plugin ?

Une boîte de dialogue native convient particulièrement aux interactions petites et ciblées : confirmations, panneaux d'information et formulaires simples.

Pour des besoins plus complexes, comme les assistants à plusieurs étapes, les galeries avancées ou les boîtes de dialogue profondément intégrées à un flux de travail CMS, un composant ou une extension dédiée peut rester l'option la plus facile à maintenir.

L'avantage de l'approche native est qu'elle fournit une base solide prise en charge par le navigateur sans introduire une autre dépendance JavaScript.

Elle réduit également la quantité de gestion personnalisée du focus et du clavier que vous devez implémenter vous-même.

Conclusion : commencez par les capacités intégrées du navigateur

Une boîte de dialogue modale ne doit pas nécessairement nécessiter une grande bibliothèque JavaScript.

L'élément natif HTML <dialog> fournit une base efficace pour des fenêtres contextuelles accessibles, des messages de confirmation et des formulaires.

Avec showModal(), close(), method="dialog" et quelques règles CSS, vous pouvez créer une interface qui fonctionne sur les navigateurs modernes tout en bénéficiant du comportement intégré du focus et du clavier.

Pour WordPress, Joomla et les sites PHP personnalisés, cela peut être une alternative efficace à l'installation d'un autre plugin pour une interaction relativement simple.

La clé est d'utiliser correctement le comportement natif, de fournir des contrôles clairs et de tester le résultat avec de véritables interactions au clavier et sur mobile.

Références officielles et techniques