Communitygithub.com

coastdigitalgroup/coastai-skills

Concevoir et implémenter un centre de notifications in-app centralisé, hautement accessible et sensible à l'état, pour regrouper les mises à jour système, les alertes utilisateur et les notifications actionnables sans perturber les espaces de travail principaux.

Qu'est-ce que coastai-skills ?

Cette compétence fournit un cadre de conception structuré et réutilisable pour créer des centres de notifications in-app, flux ou boîtes de réception. Elle résout le problème des notifications intrusives (modales) ou éphémères (toasts) en centralisant les mises à jour asynchrones tout en gérant leur hiérarchie visuelle, leurs états interactifs (lu vs non lu), leurs regroupements contextuels et leurs adaptations responsives. La compétence prend en charge plusieurs modèles de conteneur (popover déroulant, tiroir latéral, page dédiée) et inclut des spécifications détaillées pour l'accessibilité clavier et lecteur d'écran (conformité WCAG AA). Elle est idéale pour les environnements SaaS collaboratifs, les flux de travail asynchrones, les mises à jour transactionnelles et les flux sociaux, avec des règles de décision claires pour choisir la disposition appropriée en fonction de la densité de contenu et des besoins d'interaction.

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

Demander à votre IA préférée

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

Documentation

Système de Centre de Notifications

Objectif

Le Système de Centre de Notifications fournit un cadre de conception structuré et réutilisable pour les centres de notifications in-app, les flux ou les boîtes de réception. Dans les applications web modernes, en particulier les espaces de travail SaaS, les portails communautaires, les éditeurs collaboratifs et les comptes e-commerce, les notifications tiennent les utilisateurs informés des événements asynchrones (par exemple, mentions, commentaires, alertes système, mises à jour de statut de flux de travail, achèvements de tâches).

Sans un centre de notifications dédié, les applications sont obligées de s'appuyer sur des superpositions intrusives (Modales) ou des notifications transitoires facilement manquées (Toasts/Bannières). Ce système centralise ces mises à jour, gère leur hiérarchie visuelle, leurs états interactifs (lu vs non lu), leurs regroupements contextuels et leurs adaptations responsives, tout en garantissant une accessibilité complète au clavier et aux lecteurs d'écran (WCAG AA).

Cas d'Utilisation

  • Espaces de Travail Collaboratifs : Regroupement des commentaires sur les documents, dossiers partagés, affectations de tâches et mentions (par exemple, Slack, Notion, Figma).
  • Flux de Travail Asynchrones : Suivi des opérations longues comme les exportations de données, les rapports en arrière-plan, les déploiements de builds ou les traitements par lots.
  • Mises à Jour Transactionnelles : Suivi des mises à jour de livraison e-commerce, des rappels de renouvellement d'abonnement ou des confirmations de paiement.
  • Flux Sociaux et Communautaires : Gestion des likes, réponses, abonnements, invitations à des groupes et mises à jour d'activité.
  • Sécurité et État du Compte : Information des utilisateurs sur les nouvelles connexions, les changements de mot de passe ou les avertissements de quota de stockage.

Quand NE PAS Utiliser

  • Blocages Critiques : Si un événement doit empêcher l'utilisateur de terminer sa tâche en cours (par exemple, échec de paiement, session expirée, soumission de données invalides), utilisez un système-de-superposition-et-dialogue (Modal/Alertdialog).
  • Retour d'Information Immédiat pour une Tâche Unique : Pour une confirmation immédiate d'une action directe (par exemple, "Lien copié", "Paramètres enregistrés"), utilisez un Toast (voir système-de-toast-et-snackbar).
  • Annonces d'Indisponibilité Globale : Pour les alertes système à haute priorité à l'échelle du site (par exemple, "Maintenance programmée dans 30 minutes"), utilisez des bannières globales (voir système-de-bannière-et-alerte).
  • Pages d'Atterrissage Autonomes : Les pages d'atterrissage autonomes doivent minimiser les liens externes et les distractions. Les icônes de notification globales sont contre-productives.

Entrées

  1. Architecture de l'Information (Schéma de Notification) :
    • Métadonnées : Avatar/initiales de l'auteur, source de l'événement, type d'action.
    • Contenu : Titre (ce qui s'est passé), corps du texte (détails supplémentaires/contexte), horodatage.
    • État : Lu vs non lu, priorité haute/moyenne/basse, archivé.
    • Actions : Lien cible principal, actions rapides en ligne (par exemple, "Approuver", "Marquer comme lu", "Mettre en sourdine le fil").
  2. Contexte d'Affichage et Densité : L'interface est-elle un tableau de bord SaaS très dense (nécessite des éléments de liste de popover économes en espace) ou une plateforme spacieuse (peut utiliser un tiroir coulissant ou une page) ?
  3. Iconographie du Déclencheur : L'ancre visuelle (généralement une icône de cloche) et la conception du badge de notification (comptes numériques vs un simple indicateur à point).
  4. Disposition des Actions Interactives : Actions groupées disponibles (par exemple, "Tout marquer comme lu", "Tout effacer", "Paramètres de notification").

Sorties

  1. Anatomie du Badge Déclencheur : Critères de conception spécifiques pour l'icône d'en-tête, le compteur de badge numérique et l'indicateur de point silencieux.
  2. Spécification de Disposition du Conteneur : Taille, limites, positionnement et comportement du conteneur (Menu déroulant, Tiroir latéral ou Page dédiée).
  3. Anatomie de la Carte de Notification : Disposition interne explicite (avatar, corps, horodatage, point indicateur de non lu, déclencheurs d'actions rapides).
  4. Matrice de Transition d'État : Style distinct pour les états non lu vs lu, états de survol, états actifs, anneaux de focus et squelettes de chargement.
  5. Spécification Clavier et Lecteur d'Écran : Paramètres de piège de focus, structure d'index tabulaire mobile, définitions d'annonces de région en direct et descriptions aria personnalisées.

Flux de Travail

1. Concevoir le Déclencheur d'En-Tête et l'Indicateur de Badge

Le point d'entrée du centre de notifications est presque universellement situé dans l'en-tête utilitaire global (côté droit).

  • L'icône de Cloche : Choisissez une icône de cloche propre.
  • Le Badge de Compteur de Non Lus :
    • Placez un badge circulaire dans le quadrant supérieur droit de l'icône de cloche.
    • Limitez le compteur du badge à 99+ (ou 9+ sur des layouts extrêmement serrés) pour éviter le débordement du conteneur.
    • Si le compteur est à 0, le badge doit être retiré du DOM ou masqué à l'aide de display: none (ne montrez jamais 0 à l'intérieur d'une bulle rouge).
    • Incluez un aria-label ou un texte caché pour lecteur d'écran qui indique explicitement le nombre de notifications non lues (par exemple, <span class="sr-only">, 4 notifications non lues</span>).

2. Choisir le Modèle de Disposition du Conteneur

Sélectionnez la disposition en fonction de la densité, de l'appareil cible et de la quantité d'interaction requise :

  • Modèle A : Popover Déroulant (Valeur par défaut pour bureau et densité de contenu moyenne)
    • Positionné par rapport au déclencheur.
    • Dimensions recommandées : Largeur min 320px, Largeur max 420px. Hauteur limitée à 500px avec un conteneur défilable (overflow-y: auto).
    • Ancrez le popup en utilisant les mécanismes standard de popover (ou l'API Popover native) pour garantir qu'il apparaisse dans le contexte d'empilement supérieur.
  • Modèle B : Tiroir Latéral (Meilleur pour une densité de contenu élevée ou des flux d'actions complexes)
    • Glisse depuis le bord droit de l'écran, occupant toute la hauteur de la fenêtre.
    • Largeur recommandée : 360px à 480px.
    • Assombrissez l'arrière-plan de la page avec une superposition d'arrière-plan subtile (écran).
  • Modèle C : Page de Notification Dédiée (Solution de repli pour les fenêtres mobiles ou la gestion complexe de boîte de réception)
    • Une vue plein écran adaptée au tri, à la recherche, au filtrage et à la gestion en masse des archives de notifications profondes.

3. Établir la Hiérarchie et l'Anatomie Internes des Cartes

Chaque notification individuelle est une carte (un élément de liste <li> à l'intérieur d'un <ol> ou <ul>). Elle doit suivre une hiérarchie de grille verticale et horizontale stricte :

+-------------------------------------------------------------+
| (•) [Avatar]  **Jane Doe** vous a mentionné dans _Projet X_  (x) |
|               "Veuillez examiner les croquis UI révisés."  |
|               [ il y a 3 heures ]  [ Approuver ] [ Refuser ] |
+-------------------------------------------------------------+
  • Point Indicateur de Non Lu (Ancre Horizontale) : Placez un petit point de couleur primaire à contraste élevé (par exemple, bleu ou violet) à l'extrême gauche. C'est l'ancre de balayage la plus rapide pour les éléments non lus.
  • Zone d'Avatar/icône : Placez un avatar circulaire (pour les événements générés par l'utilisateur) ou une icône utilitaire catégorisée dans un arrière-plan coloré (pour les événements système) à côté de l'indicateur.
  • Bloc de Texte (Flux Vertical) :
    • Titre/En-tête : Texte en gras mettant en évidence l'acteur et l'action.
    • Extrait : Texte plus petit et atténué montrant le contenu secondaire (par exemple, texte de commentaire, description d'erreur). Limitez à 2 lignes de texte maximum avec CSS line-clamp.
    • Horodatage : Texte petit et atténué (par exemple, 12px) montrant l'heure relative (par exemple, "il y a 5m", "Hier").
  • Actions Rapides (Déclencheurs Contextuels) :
    • Placez les boutons d'action rapide alignés sous l'extrait de texte (par exemple, "Accepter l'invitation", "Voir le commentaire").
    • Fournissez un déclencheur secondaire subtil (par exemple, un bouton de menu débordant, ou un bouton direct "Marquer comme lu") au survol/au focus dans le coin droit.
    • L'icône de fermeture/refus (X) doit être positionnée dans le coin supérieur droit, mesurant au moins 24x24px pour les interactions tactiles.

4. Créer des Transitions d'État Claires

Fournissez des états distincts pour refléter l'interaction de l'utilisateur :

  • État Non Lu : Fond clair, texte en gras, point indicateur bleu visible.
  • État Lu : Atténue le fond non lu, change le poids du texte en normal, masque le point indicateur.
  • État de Survol/Focus : Décale légèrement la couleur de fond (par exemple, du blanc à un gris neutre doux) et révèle les déclencheurs secondaires en ligne (par exemple, "Archiver", "Marquer comme lu").
  • État Focus : Anneaux de focus à contraste élevé autour des éléments individuels lorsqu'ils sont navigués au clavier. Gardez le focus visible et net (contour minimum de 2px avec décalage).
  • État Désactivé : Si une carte d'action est en cours de traitement (par exemple, en cliquant sur "Approuver"), appliquez un spinner de chargement en ligne, réduisez l'opacité à 0.5 et définissez les attributs du bouton sur disabled pour éviter les doubles clics.

5. Définir les Opérations Groupées et les États Vides

  • Navigation en Pied de Page : Fournissez toujours un lien en pied de page vers "Voir toutes les notifications" (lien vers une page dédiée) ou "Tout marquer comme lu."
  • État Vide : Lorsqu'aucune notification n'est présente, ou lorsque toutes les notifications sont effacées, affichez un état vide contenant un visuel encourageant (par exemple, une coche ou une cloche), un en-tête neutre ("Tout est à jour !") et un lien descriptif secondaire vers "Paramètres de notification" (voir système-d-état-vide).

6. Mettre en Œuvre la Gestion du Focus Clavier et du Lecteur d'Écran

  • Bascule du Déclencheur : Appuyer sur Entrée ou Espace sur l'icône de cloche active/désactive le popover. Appliquez aria-expanded="true/false" et aria-controls="notification-panel-id".
  • Piège de Focus (pour les Tiroirs et Popovers) : Lorsqu'il est ouvert, le focus clavier doit se déplacer immédiatement vers le premier élément actionnable à l'intérieur du panneau (généralement le bouton "Tout marquer comme lu" ou le premier élément de notification). Le focus doit être piégé à l'intérieur du panneau tant qu'il est visible. Appuyer sur Échap doit fermer le panneau et ramener le focus directement sur l'icône de cloche.
  • Index Tabulaire Mobile / Navigation dans la Liste : S'il y a des dizaines d'éléments de notification, permettez aux utilisateurs du clavier de naviguer entre les cartes à l'aide des touches Flèche Haut et Flèche Bas, en gardant un seul point d'arrêt de tabulation (tabindex="0" pour l'élément actif, tabindex="-1" pour les autres). Cela évite de forcer les utilisateurs du clavier à tabuler à travers 50 liens pour atteindre la fin de la page.
  • Annonces du Lecteur d'Écran : Utilisez une région aria-live="polite" cachée pour annoncer les mises à jour du compteur de non lus lorsqu'elles se produisent dynamiquement (par exemple, "Nouvelle notification de Sarah").

Règles de Décision

Règle 1 : Menu Déroulant vs Tiroir Latéral vs Page

Choisissez la structure du conteneur en utilisant cette grille de disposition :

  • Choisissez le Popover Déroulant si : L'application a en moyenne moins de 10 à 15 notifications, contient principalement des mises à jour courtes et les actions sont simples (comme un lien direct ou un refus rapide).
  • Choisissez le Tiroir Latéral si : Le panneau de notifications comprend des onglets interactifs (par exemple, "Tout", "Mentions", "Archive"), nécessite des résumés de cartes multi-lignes riches ou nécessite des champs de formulaire complexes (comme une saisie de texte pour répondre directement dans la notification).
  • Choisissez la Page Dédiée si : L'utilisateur gère des charges de travail lourdes en notifications (par exemple, boîte de révision PR GitHub, tickets de support Zendesk, alertes de boutique Shopify) qui nécessitent des filtres de recherche robustes, des sélections multiples par coche et des flux de travail d'archivage massifs.

Règle 2 : Indicateurs Avatar vs Icône

  • Utilisez un Avatar Utilisateur (image ou initiales) si la notification est un événement social ou de collaboration directe déclenché par un humain spécifique (par exemple, "Sarah a partagé un fichier").
  • Utilisez une Icône Système (avec des couleurs spécifiques au statut : rouge pour alerte, jaune pour avertissement, bleu pour info) si l'événement est généré par le système (par exemple, "Sauvegarde de base de données terminée").

Règle 3 : Comportement de l'Action Marquer comme Lu

  • Cliquer sur la carte de notification doit à la fois rediriger l'utilisateur vers la cible du lien profond et marquer l'élément comme lu.
  • Fournissez une icône de coche "Marquer comme lu" dédiée et visible sur la carte, permettant aux utilisateurs de marquer les éléments comme lus sans quitter le panneau.

Contraintes

1. Contraste et Taille (WCAG AA)

  • Contraste du Texte : Assurez-vous que toutes les copies de notification respectent le rapport de contraste 4.5:1. Les horodatages et les extraits atténués ne doivent pas descendre en dessous de 4.5:1 (ou 3:1 pour les grands textes).
  • Cibles Tactiles : Les cibles tactiles pour les boutons individuels (icônes de fermeture, liens accepter/refuser, coches marquer comme lu) doivent respecter la taille minimale de cible WCAG 2.2 SC 2.5.8 de 24x24px.
  • Contraste Clavier : Les anneaux de focus doivent avoir un rapport de contraste minimum de 3:1 par rapport à l'arrière-plan de la carte.

2. Réactivité

  • Bureau : Les panneaux flottants doivent se positionner intelligemment. Si le déclencheur est près du bord droit de l'écran, le popover doit s'aligner sur son côté droit pour éviter le rognage.
  • Fenêtres Mobiles (< 768px) : Transformez le popover déroulant du bureau en un Panneau Plein Écran ou une Feuille Coulissante Alignée en Bas pour garantir l'accessibilité avec le pouce et empêcher les petits conteneurs de popover non défilables.

3. Empilement Dynamique

  • Assurez-vous que le z-index du popover ou du tiroir est configuré au-dessus des éléments de disposition standard mais en dessous des déclencheurs modaux (par exemple, --z-index-popover: 1000, --z-index-modal: 2000).

Schémas d'Échec Courants

  • La "Boîte de Réception Inéluctable" : Ouvrir un popover de notification déroulant sur le bureau, mais ne pas fournir d'écouteur de fermeture par touche Échap. Les utilisateurs sont obligés de trouver et de cliquer sur un petit "X" ou de cliquer à l'extérieur pour le fermer.
  • La Boucle du "Badge Bloqué" : Un badge de notification affichant 3 éléments non lus, mais l'ouverture du panneau ne met pas visuellement en évidence les cartes non lues, ni ne fournit un moyen clair de les marquer comme lues. Le badge reste bloqué, provoquant une fatigue de l'utilisateur et une éventuelle cécité aux bannières.
  • Le Flux "Fourre-Tout" : Bourrer des paragraphes entiers d'e-mails, des journaux de base de données bruts et des promotions marketing dans un petit panneau déroulant, provoquant un débordement de la disposition et écrasant la hiérarchie visuelle.
  • Décalage de Disposition lors du Défilement : Des popovers stylisés avec des coordonnées de pixels statiques qui ne parviennent pas à rester attachés à l'icône de cloche d'en-tête lors du défilement, flottant aléatoirement sur le contenu.
  • Doubles Contours de Focus : Double couche de style de focus où à la fois la carte du conteneur externe et le bouton de lien profond interne capturent le focus simultanément, obligeant les utilisateurs du clavier à tabuler deux fois par notification.

Critères de Validation

  • Comportement du Compteur de Badge : Si le nombre de non lus est 0, le point rouge ou l'indicateur numérique est complètement masqué de la vue.
  • Contraste d'État : Les cartes non lues sont clairement distinguées visuellement des cartes lues (à l'aide d'arrière-plans, de poids de texte et de points indicateurs).
  • Tailles de Cible : Chaque bouton/lien cliquable à l'intérieur de la carte respecte la cible tactile minimale WCAG 2.2 24x24px.
  • Transformation Réactive : Sur mobile et tablettes, le panneau de notifications occupe toute la largeur de l'écran (pleine largeur et hauteur, de préférence un panneau coulissant depuis la droite ou depuis le bas).
  • Comportement de Bascule : Ouvrir le panneau à l'aide du bouton déclencheur, fermer le panneau avec la touche Échap et le focus revient sur le bouton déclencheur.
  • Détection de Nouveau Contenu : Un nombre dynamique de notifications non lues est correctement annoncé aux technologies d'assistance lorsqu'il se produit.

Références

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