Communitygithub.com

Système de Superposition et de Dialogue

Concevoir un cadre systématique pour les couches d'interface utilisateur non persistantes (Modales, Tiroirs et Popovers) qui équilibre la concentration de l'utilisateur, le contexte et les niveaux d'interruption.

Qu'est-ce que Système de Superposition et de Dialogue ?

La compétence « Système de Superposition et de Dialogue » fournit une méthodologie complète pour gérer les couches de contenu temporaires qui se superposent à l'interface principale, garantissant que les interruptions sont proportionnelles à la tâche de l'utilisateur, que le contexte est préservé autant que possible et que l'interface reste accessible et réactive lors de l'utilisation de Modales, de Tiroirs ou de Popovers. Cette compétence est essentielle pour les développeurs et les concepteurs d'interface utilisateur qui souhaitent éviter des motifs d'échec courants tels que la confusion de superposition, la perte de contexte ou les fermetures invisibles, et elle est applicable sur les plateformes de bureau comme mobiles et réactives. Elle fonctionne en catégorisant d'abord l'interruption requise (haute pour les modales, moyenne pour les tiroirs, faible pour les popovers), puis en définissant la hiérarchie interne, l'élévation et l'arrière-plan, l'adaptation réactive et les modèles de fermeture. Les règles de décision claires aident à choisir entre une modale et un tiroir, à prioriser les tiroirs inférieurs sur mobile et à limiter les superpositions à deux étapes internes, tandis que des contraintes d'accessibilité (piégeage du focus, `inert`, ARIA) et de réactivité garantissent une expérience robuste. Une liste de validation inclut des vérifications pour le niveau d'interruption, la hiérarchie, l'adaptation mobile, la logique de fermeture, la gestion du focus, l'élévation et l'inertie de l'arrière-plan.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/overlay-and-dialog-system

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Système de Superposition et de Dialogue ?

Objet

La compétence Système de Superposition et de Dialogue fournit une méthodologie pour gérer les couches de contenu temporaires qui se trouvent au-dessus de l'interface principale. Elle garantit que les interruptions sont proportionnelles à la tâche de l'utilisateur, que le contexte est préservé autant que possible et que l'interface reste accessible et réactive lors de l'utilisation de Modales, de Tiroirs ou de Popovers.

Cas d'utilisation

  • Concevoir un flux de confirmation pour une action destructive (Modale).
  • Créer un espace de travail secondaire pour éditer des détails complexes sans perdre le contexte de la page (Tiroir).
  • Implémenter des aides contextuelles ou des infobulles pour des éléments d'interface utilisateur spécifiques (Popover).
  • Concevoir une couche de découverte spécifique au mobile pour les filtres ou la recherche (Tiroir).

Quand ne PAS l'utiliser

  • Navigation principale : N'utilisez pas de superpositions pour la structure principale du site ; utilisez plutôt site-navigation-system.
  • Contenu persistant : Si l'information est essentielle à voir en permanence par l'utilisateur, elle doit faire partie de la mise en page de base de la page, et non d'une superposition.
  • Flux complexes multi-pages : Si une tâche nécessite plus de 2 à 3 étapes, envisagez une page dédiée plutôt qu'une modale pour éviter la désorientation de l'utilisateur.
  • Notifications Toast/Snackbar : Pour les retards de statut passifs et non bloquants (par exemple, « Enregistré », « Copié dans le presse-papiers »), utilisez toast-and-snackbar-system à la place — il couvre en profondeur le positionnement, l'empilement, la durée et l'accessibilité pour cette couche.

Entrées

  1. Volume de contenu : Quelle quantité d'informations doit être affichée ?
  2. Niveau d'interruption : L'utilisateur doit-il terminer cette tâche avant de continuer, ou est-ce facultatif ?
  3. Contexte du déclencheur : D'où vient l'utilisateur et que s'attend-il à voir se produire ?
  4. Plateforme / Fenêtre d'affichage : Est-ce pour mobile, ordinateur de bureau ou un hybride réactif ?

Sorties

  1. Sélection du motif : Un choix clair entre Modale, Tiroir ou Popover basé sur la matrice d'interruption.
  2. Spécification de l'anatomie : Régions définies (En-tête, Contenu, Pied de page/Actions) et leur hiérarchie interne.
  3. Spécification comportementale : Règles pour le comportement de l'arrière-plan, les déclencheurs de fermeture et l'adaptation réactive.
  4. Exigences d'accessibilité : Gestion du focus et définitions des rôles ARIA.

Flux de travail

1. Catégoriser par niveau d'interruption

Déterminez la « gravité » requise de la superposition :

  • Niveau 1 (Élevé) : Modale. Désactive l'arrière-plan. À utiliser pour les décisions critiques ou les tâches ciblées.
  • Niveau 2 (Moyen) : Tiroir. Glisse depuis le bord. À utiliser pour les sous-tâches complexes qui bénéficient de la vue du contexte parent.
  • Niveau 3 (Faible) : Popover. Ancré à un élément spécifique. À utiliser pour les paramètres contextuels ou les informations.

Pour les retards de statut passifs et non bloquants (Niveau 4), voir toast-and-snackbar-system — cela sort du cadre ici.

2. Définir la hiérarchie interne (Anatomie)

Appliquez visual-hierarchy-system à la superposition :

  • En-tête : Titre clair et mécanisme de « Fermeture » cohérent (bouton X).
  • Corps : Zone de contenu principale. Si le contenu est long, définissez le comportement de défilement (en-tête/pied de page fixe).
  • Pied de page : Actions principales et secondaires, alignées de manière cohérente (généralement alignées à droite pour le bureau, en pleine largeur pour le mobile).

3. Établir l'élévation et l'arrière-plan

  • Stratégie d'indice Z : Assurez-vous que les superpositions se trouvent dans le bon contexte d'empilement. Préférez l'élément natif <dialog> pour les Modales — il gère son propre empilement de couche supérieure, fournit le pseudo-élément ::backdrop pour le voile, et gère la fermeture par Escape de manière native.
  • Arrière-plan (Voile) : Utilisez-le pour les Modales et les Tiroirs afin d'assombrir l'arrière-plan et de concentrer l'attention. Définissez si le clic sur l'arrière-plan ferme la superposition. Avec <dialog>, stylisez le voile via ::backdrop au lieu d'un <div> de superposition rendu manuellement.
  • Inertie de l'arrière-plan : Lorsqu'une superposition est ouverte, le reste de la page doit être non interactif et masqué pour les technologies d'assistance. <dialog>.showModal() fait cela automatiquement ; pour les superpositions personnalisées (non <dialog>), appliquez l'attribut inert au contenu de l'arrière-plan plutôt que de vous fier uniquement à aria-hidden.
  • Ombres : Utilisez la profondeur pour indiquer la position de la superposition au-dessus de la couche de base.

4. Concevoir pour l'adaptation réactive

Les superpositions doivent se transformer en fonction de la taille de l'écran :

  • Popover bureau -> Tiroir mobile : Les menus contextuels de petite taille deviennent souvent des tiroirs alignés en bas sur mobile pour une meilleure portée du pouce.
  • Modale bureau -> Plein écran mobile : Les grandes modales doivent occuper la totalité de la fenêtre d'affichage sur les petits écrans pour maximiser l'espace.
  • Comportement du tiroir : Assurez-vous que les tiroirs ne dépassent pas 90 % de la largeur de la fenêtre d'affichage sur mobile.

5. Définir les modèles de fermeture et de sortie

  • Fournissez au moins trois façons de quitter une superposition non critique : bouton « Fermer », touche Escape et clic sur l'arrière-plan.
  • Pour les modales critiques (alertes), exigez une action explicite (par exemple, « Annuler » ou « Confirmer »).

Règles de décision

  • La règle « Modale vs. Tiroir » : Si l'utilisateur a besoin de se référer au contenu de l'arrière-plan pendant qu'il travaille, utilisez un Tiroir. Si la tâche est un moment « arrête-toi et corrige », utilisez une Modale.
  • La règle du « Pouce » : Sur mobile, privilégiez les Tiroirs en bas pour les actions afin de les maintenir dans la portée naturelle du pouce.
  • La règle des « Deux étapes » : Si une superposition nécessite plus de deux « vues » ou étapes internes, elle appartient probablement à sa propre page.
  • Logique de l'arrière-plan : Autorisez « Cliquer à l'extérieur pour fermer » uniquement pour les superpositions non destructives. Jamais pour les formulaires où des données pourraient être perdues.

Contraintes

  • Accessibilité : Doit être navigable au clavier. Les modales doivent piéger le focus (l'élément natif <dialog> le fait par défaut lorsqu'il est ouvert via showModal()). Le contenu de l'arrière-plan doit être rendu inert (ou équivalent) afin que le lecteur d'écran et le focus clavier ne puissent pas s'en échapper. Utilisez role="dialog" ou role="alertdialog" avec aria-modal="true" et aria-labelledby pointant vers le titre lorsque vous n'utilisez pas l'élément natif.
  • Réactivité : Les superpositions ne doivent jamais provoquer de défilement horizontal. Le contenu à l'intérieur doit être réactif.
  • Hiérarchie : Le H1/Titre de la superposition doit être l'élément le plus important dans le conteneur.

Motifs d'échec courants

  • Confusion de superposition : Empiler plusieurs modales les unes sur les autres.
  • Perte de contexte : Utiliser une modale qui recouvre exactement l'information dont l'utilisateur a besoin pour terminer la tâche.
  • La « Fermeture invisible » : Cacher le bouton de fermeture ou le rendre trop petit pour le tactile (minimum 44x44 px).
  • Conflits de défilement : Permettre à la page d'arrière-plan de défiler pendant qu'une superposition est ouverte (entraîne une désorientation).
  • Actions incohérentes : Inverser la position des boutons « Annuler » et « Confirmer » dans différentes superpositions.

Critères de validation

  • Le motif choisi (Modale/Tiroir/Popover) correspond au niveau d'interruption de la tâche.
  • La hiérarchie interne est claire avec un titre distinct et une action principale.
  • L'adaptation réactive (par exemple, Popover vers Tiroir) est définie pour le mobile.
  • La logique « Cliquer à l'extérieur pour fermer » est appropriée pour le risque de données.
  • La gestion du focus et les exigences d'accessibilité clavier sont spécifiées.
  • L'élévation (ombres/voiles) distingue la couche de la page de base.
  • Le contenu de l'arrière-plan est rendu inert (ou l'élément natif <dialog> est utilisé) chaque fois qu'une Modale ou un Tiroir est ouvert.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Skills associés