Communitygithub.com

Système d'Interface de Paramètres

Concevoir un cadre systématique pour les interfaces de paramètres utilisateur, d'espace de travail et d'application, établissant une navigation claire, un regroupement robuste des sections et des modèles de persistance d'état fiables.

Qu'est-ce que Système d'Interface de Paramètres ?

Le Système d'Interface de Paramètres standardise la conception des écrans de configuration dans les applications SaaS, les panneaux d'administration et les portails utilisateur. Il résout les problèmes courants comme la navigation fragmentée, le manque de réactivité, les barrières d'accessibilité et la perte de données non sauvegardées. Le système couvre la composition spatiale, les architectures de navigation (barre latérale, onglets, accordéon), les modèles de persistance d'état (sauvegarde automatique vs sauvegarde manuelle par lot), et les affordances visuelles pour réduire la charge cognitive. Destiné aux développeurs et designers UX/UI, il est compatible avec Claude Code, Cursor et Codex, et s'applique aux profils utilisateur, aux paramètres d'espace de travail SaaS, aux centres de notifications, aux hubs de facturation et aux configurations développeur. La méthode propose un flux de travail en six étapes : regroupement des paramètres, choix de la disposition, établissement du modèle de sauvegarde, conception des matrices denses, structuration de la "Zone Dangereuse" et adaptation mobile. Des règles de décision claires aident à choisir entre auto-sauvegarde et sauvegarde manuelle, tandis que des contraintes d'accessibilité (WCAG 2.2) et de réactivité sont intégrées.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/settings-interface-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 d'Interface de Paramètres ?

Objectif

Le Système d'Interface de Paramètres fournit une méthodologie pour organiser, concevoir et structurer les préférences utilisateur, les configurations de compte, les paramètres d'espace de travail et les portails de facturation. Les interfaces de paramètres sont souvent négligées, ce qui entraîne des structures visuelles fragmentées, des modèles de navigation déconnectés, une faible réactivité et de sérieuses barrières d'accessibilité. Ce système établit une approche standardisée de la composition spatiale, des architectures de navigation, des modèles de persistance d'état (par exemple, sauvegarde automatique vs. sauvegarde manuelle par lot) et des affordances visuelles pour réduire la charge cognitive et prévenir la perte de données non sauvegardées.

Cas d'Utilisation

  • Profils & Comptes Utilisateurs : Conception d'interfaces pour la mise à jour des informations personnelles, des identifiants de sécurité et des préférences.
  • Administration d'Espace de Travail SaaS : Organisation des paramètres multi-locataires ou d'équipe, rôles des membres, intégrations et permissions.
  • Centres de Configuration des Notifications : Création de tableaux de bascule granulaires basés sur des matrices pour les alertes par e-mail, push et in-app.
  • Hubs de Facturation & Abonnement : Conception d'aperçus clairs des niveaux de tarification, des métriques du plan actuel, des méthodes de paiement et des listes de factures historiques.
  • Paramètres Développeur : Organisation d'options techniques complexes comme la rotation des clés API, les webhooks et les bascules d'environnement.

Quand NE PAS Utiliser

  • Barres de Consentement & Confidentialité Implicites : Pour l'acceptation des cookies, la catégorisation des cookies et les superpositions de conformité, utilisez consent-and-preference-system.
  • Formulaires d'Onboarding Ponctuels : Pour des étapes d'inscription simples à une seule colonne ou la capture d'enquête initiale, utilisez form-design-system.
  • Interfaces de Faible Complexité (<5 paramètres au total) : Pour des configurations extrêmement simples, ne construisez pas un système multi-pages imbriqué ; intégrez ces options directement dans le menu déroulant du profil dans l'en-tête global ou les pieds de page de la barre latérale.

Entrées

  1. Inventaire des Paramètres : Un catalogue complet de tous les attributs configurables, regroupés logiquement.
  2. Modèle de Persistance d'État : Détermination si les modifications sont appliquées instantanément (sauvegarde automatique) ou conservées jusqu'à confirmation (sauvegarde manuelle par lot).
  3. Rôles d'Accès Utilisateur : Informations sur qui peut voir/modifier des lignes spécifiques (par exemple, Administrateur, Éditeur de Facturation, Visualiseur).
  4. Jetons d'Espacement & Typographiques : Valeurs de conception existantes (issues de fluid-spacing-system et fluid-typography-system).

Sorties

  1. Modèle de Navigation des Paramètres : Choix de la disposition de navigation (Barre latérale, Sous-onglets ou Accordéon) en fonction de la densité des sections.
  2. Spécification de Disposition Maître-Détail : Composition en grille/flex mappant les contrôles de la barre latérale à leurs panneaux de paramètres actifs correspondants.
  3. Persistance d'État & UX du Journal des Modifications : Modèles visuels et auditifs pour la confirmation de sauvegarde, les états de chargement et les bannières d'état non sauvegardé.
  4. Annotations Accessibles des Champs & Permissions : Chemins clavier, balises de légende sémantique et règles de style claires pour les états désactivé/en lecture seule.

Flux de Travail

1. Regrouper et Prioriser les Paramètres (Regroupement)

Effectuez un tri par cartes ou un regroupement thématique sur l'inventaire des paramètres :

  • Niveau Personnel : Informations du profil, avatar, identifiants de connexion, sécurité personnelle (MFA).
  • Niveau Organisation/Espace de Travail : Nom de l'espace de travail, invitations de membres, rôles, intégrations globales.
  • Niveau Livraison/Système : Règles de notification, alertes sonores, options de thème (Mode Sombre/Clair).
  • Niveau Financier : Niveaux de plan, cartes de crédit, contact de facturation, tableaux de factures.
  • Zone Dangereuse : Supprimer le compte, désactiver l'espace de travail ou transférer la propriété.

2. Choisir la Disposition & l'Architecture de Navigation

Sélectionnez le modèle de navigation spatiale :

  • Piloté par Barre Latérale (Maître-Détail) : Recommandé pour les configurations SaaS B2B et denses. Utilisez une colonne de navigation persistante à gauche (Maître) et un panneau de contenu défilant à droite (Détail).
  • Piloté par Onglets : Idéal pour les panneaux de paramètres légers à moyens (<5 vues). Utilisez un menu d'onglets secondaire horizontal (en utilisant tab-ui-system ou segmented-control-system) sous l'en-tête principal de la page de paramètres.
  • Défilement sur une Seule Page (Accordéon) : Idéal pour les applications mobiles simples ou les listes de paramètres où les sous-sections peuvent se développer/réduire en ligne pour garder une hauteur verticale gérable.

3. Établir le Modèle de Sauvegarde et de Retour d'Information

Choisissez un mécanisme de persistance d'état clair pour chaque carte de paramètres :

  • Modèle de Sauvegarde Automatique :
    • Utilisé pour les options isolées à faible risque (activation/désactivation du mode sombre, préférences de notification).
    • Retour d'Information : Affichez un spinner/indicateur de chargement en ligne et un indicateur textuel "Enregistré" clair à côté du bouton à bascule. L'indicateur doit disparaître après 1 à 2 secondes d'inactivité.
  • Modèle de Sauvegarde par Lot (État Non Sauvegardé) :
    • Utilisé pour les formulaires à enjeux élevés ou les champs fortement corrélés (mise à jour du mot de passe, adresse de facturation).
    • Retour d'Information : Affichez une bannière flottante en position fixe dans l'en-tête ou le pied de page indiquant "Vous avez des modifications non enregistrées."
    • Actions : Fournissez deux boutons proéminents : "Enregistrer les modifications" (CTA Principal) et "Ignorer" (Texte secondaire). Désactivez la navigation dans la barre latérale/les onglets lorsqu'il y a des modifications non enregistrées, ou déclenchez une modale de confirmation "Perte des modifications non enregistrées" si l'utilisateur tente de cliquer ailleurs.

4. Concevoir des Matrices de Paramètres à Haute Densité

Pour les centres de notifications ou les tableaux de permissions granulaires :

  • Utilisez des Grilles Matricielles : Alignez les cases à cocher ou les interrupteurs dans des colonnes correspondant aux canaux de livraison (par exemple, E-mail, In-app, SMS) et des lignes correspondant aux événements (par exemple, "Mentionné dans un commentaire", "Tâche assignée").
  • Alignement des En-têtes de Colonne : Gardez les étiquettes collantes lors du défilement vertical pour préserver le contexte.
  • Surbrillance des Lignes Prête pour le Clavier : Utilisez les styles de interactive-state-system afin que la mise au point d'une cellule mette en évidence sa ligne correspondante.

5. Structurer la Carte "Zone Dangereuse"

Les actions destructrices et irréversibles nécessitent un traitement visuel dédié :

  • Isolement Visuel : Regroupez les actions (Désactiver l'Espace de Travail, Supprimer le Compte) dans une seule carte tout en bas de la disposition.
  • Alertes de Danger à Contraste Élevé : Utilisez des bordures rouges, un fond d'avertissement rouge clair subtil et des avertissements en gras détaillant les conséquences.
  • Modale de Double Confirmation : Ne déclenchez pas la destruction instantanément. Cliquer sur le bouton d'action doit ouvrir une modale (overlay-and-dialog-system) obligeant l'utilisateur à taper explicitement le nom de la ressource (par exemple, "supprimer nom-espace-travail") pour confirmer.

6. Concevoir pour la Réactivité Mobile

  • Réduction à une Liste Maître Linéaire : Sur les fenêtres de moins de 768px, réduisez la liste de la barre latérale et le panneau de détails du contenu en une liste maître linéaire.
  • Navigation par Sous-page : Cliquer sur une option de la barre latérale sur mobile ouvre un panneau coulissant en pleine largeur contenant uniquement cette section de détail, avec un en-tête de fil d'Ariane collant "Retour aux Paramètres".
  • Agrandir les Cibles Tactiles : Étendez les cases à cocher, les interrupteurs et les cibles de fermeture à un minimum de 44px x 44px pour s'adapter à l'interaction mobile pilotée par le pouce.

Règles de Décision

  • Sauvegarde Automatique vs. Sauvegarde Manuelle : Utilisez la Sauvegarde Automatique lorsqu'un bouton à bascule/champ agit comme une préférence utilisateur immédiate (comme le thème sombre ou l'alerte sonore). Utilisez la Sauvegarde Manuelle par Lot lorsque les champs sont logiquement regroupés et dépendent d'une validation (comme le changement d'e-mail/mot de passe, les informations de facturation) pour éviter des mises à jour incomplètes ou invalides de la base de données.
  • Le Seuil de la Barre Latérale : Utilisez une navigation par barre latérale verticale persistante pour les suites de paramètres contenant 5 sections ou plus distinctes. Pour 4 sections ou moins, utilisez une barre d'onglets secondaire horizontale sous l'en-tête principal.
  • Rejet des Modifications Non Enregistrées : Si un utilisateur modifie un champ dans une vue à sauvegarde manuelle et clique sur un onglet/élément de navigation sans enregistrer, bloquez toujours la navigation et déclenchez une boîte de dialogue de confirmation : "Ignorer les modifications non enregistrées ?"

Contraintes

  • Accessibilité (Structure Sémantique) :
    • Regroupez les champs avec les balises <fieldset> et <legend> pour garantir que les technologies d'assistance lisent le contexte des contrôles imbriqués.
    • Les contrôles de formulaire doivent utiliser des étiquettes associées par programme (<label for="...">) ou aria-labelledby.
    • Utilisez aria-live="polite" sur les indicateurs de sauvegarde automatique en ligne afin que les lecteurs d'écran soient informés des sauvegardes en arrière-plan sans perturber le focus de la frappe.
    • Les indicateurs de focus actif doivent satisfaire un rapport de contraste d'au moins 3:1 et ne doivent pas être masqués par des en-têtes collantes ou la bannière de modifications non enregistrées (WCAG 2.2 SC 2.4.11).
  • Réactivité : Les tableaux en grille multi-colonnes doivent s'empiler en lignes propres ou en tableaux à défilement horizontal sur les petites fenêtres. Les éléments textuels doivent utiliser word-break: break-word pour empêcher les longues clés API ou les URL de webhook de déborder.
  • Hiérarchie Visuelle : Regroupez les paramètres connexes dans des "cartes" visuellement isolées avec une marge standard (--space-l) pour réduire la charge cognitive par rapport à une seule liste infinie.

Modèles d'Échec Courants

  • "L'Échec Silencieux de Sauvegarde" : Lorsqu'un bouton à bascule à sauvegarde automatique échoue en arrière-plan sans afficher d'état d'erreur, laissant l'utilisateur croire que sa modification a été enregistrée.
  • "La Perte Accidentelle" : Naviguer loin d'une page de paramètres à moitié remplie perd toutes les modifications sans afficher de modale de confirmation ou conserver l'état.
  • "La Grille de Paramètres Mystérieuse" : Créer de grandes matrices multi-dimensionnelles (par exemple, notifications) sans en-têtes de colonne ou de ligne persistants, forçant les utilisateurs à aligner les éléments avec leurs doigts sur l'écran.
  • Mauvais Pièges de Focus dans les Modales de Zone Dangereuse : Laisser le focus clavier s'échapper de la modale de confirmation de suppression vers la page d'arrière-plan, permettant aux utilisateurs de soumettre accidentellement des paramètres d'arrière-plan tout en essayant de taper une confirmation de suppression.
  • Étiquetage par Espace Réservé : Utiliser le texte d'espace réservé des champs de saisie au lieu de vraies balises <label> persistantes. Une fois la saisie commencée, le contexte est perdu.

Critères de Validation

  • Une navigation par barre latérale verticale persistante est utilisée pour 5 vues de paramètres ou plus, se réduisant élégamment à une navigation par sous-vue coulissante sur les tailles d'écran mobiles.
  • Les boutons à bascule de préférence à faible risque utilisent le modèle de Sauvegarde Automatique avec un indicateur de statut de chargement en ligne aria-live.
  • Les formulaires critiques à champs multiples utilisent le modèle de Sauvegarde Manuelle par Lot avec une bannière flottante/fixe persistante "Modifications non enregistrées".
  • Les actions destructrices sont regroupées dans une carte "Zone Dangereuse" visuellement isolée avec une boîte de dialogue de confirmation en plusieurs étapes.
  • Le HTML sémantique (<fieldset>, <legend>, <label>) est utilisé pour tous les groupes de saisie.
  • Les indicateurs de focus actif satisfont aux règles de contraste WCAG 2.2 et ne sont pas masqués par des éléments superposés ou des bannières flottantes.
  • Le rapport de contraste de tout le texte respecte le niveau WCAG AA (4.5:1 minimum, 3:1 pour les grands textes/icônes).
  • Les cibles tactiles sur mobile satisfont la taille 44px x 44px pour les entrées principales.

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