Communitygithub.com

Système de Témoignages et Citations

Concevoir et structurer des témoignages clients qualitatifs, des citations phares et des composants de mention de source pour établir la crédibilité, la confiance et la preuve sociale, en conformité avec les normes d'accessibilité WCAG AA.

Qu'est-ce que Système de Témoignages et Citations ?

Ce système fournit un cadre de conception et d'espacement systématique pour les témoignages clients qualitatifs et les citations. Au lieu de traiter la preuve sociale comme un élément secondaire, il établit des règles structurelles, typographiques et de citation qui maximisent la crédibilité visuelle et l'authenticité tout en garantissant une accessibilité totale. Il fait le pont entre les avis bruts générés par les utilisateurs (gérés par `review-and-rating-system`) et les arguments marketing hautement organisés. Le système est conçu pour fonctionner sur toute plateforme nécessitant une preuve sociale (sites web, applications, supports de vente) et repose sur une anatomie sémantique utilisant `<figure>`, `<blockquote>` et `<figcaption>`. Il propose différents motifs de mise en page (spotlight héro, grille de cartes, citation intégrée) et intègre des indicateurs de confiance (photos réelles, logos, badges de vérification) pour lutter contre le scepticisme envers les faux témoignages. L'ensemble est strictement conforme aux exigences WCAG AA, notamment en matière de contraste, de structure sémantique et de navigation clavier.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/testimonial-and-quote-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 Témoignages et Citations ?

Objectif

Le Système de Témoignages et Citations fournit un cadre de conception et d'espacement systématique pour les témoignages clients qualitatifs et les citations. Au lieu de traiter la preuve sociale comme un élément secondaire, ce système établit des règles structurelles, typographiques et de citation qui maximisent la crédibilité visuelle et l'authenticité tout en garantissant une accessibilité totale. Il fait le pont entre les avis bruts générés par les utilisateurs (gérés par review-and-rating-system) et les arguments marketing hautement organisés.

Cas d'Usage

  • Pages d'Atterrissage : Placer des citations de réussite client importantes pour soutenir les appels à l'action principaux et secondaires.
  • Pages de Service/Produit : Intégrer des citations clients contextuellement pertinentes qui répondent directement aux points de friction ou objections courants.
  • Centres d'Études de Cas & Histoires de Réussite : Concevoir les citations d'accroche qui résument le résultat principal ou le ROI d'une histoire client.
  • Pages À Propos et Équipe : Afficher des citations de fondateurs, partenaires clés ou employés.
  • Supports de Vente Entreprise : Structurer des citations à fort impact provenant de représentants clients de haut niveau (VP, Directeur, C-suite).

Quand NE PAS Utiliser

  • Listes de Retour d'Information Quantitatif : Pour les avis générés par les utilisateurs à volume élevé (par ex., 500 avis individuels de 1 à 5 étoiles) ; utilisez plutôt review-and-rating-system.
  • Tableaux de Données/Grilles d'Attributs de Produit : Pour afficher des spécifications techniques ; utilisez property-and-attribute-system ou data-table-ui-system.
  • Contenu Principal de la Page : Les témoignages doivent soutenir, et non remplacer, les informations produit principales ou les propositions de valeur fondamentales.
  • Avis de Non-Responsabilité et Conditions d'Utilisation : Pour un texte juridiquement contraignant strict nécessitant un traitement formel et non narratif.

Entrées

Pour concevoir un composant de témoignage ou de citation efficace, les informations suivantes sont requises :

  1. Contenu de la Citation : Le texte réel du témoignage, idéalement affiné pour être concis et centré sur un seul résultat ou avantage clé.
  2. Identité de l'Auteur : Nom de la personne, titre professionnel et entreprise.
  3. Ressources Visuelles : Photo de haute résolution, logo de l'entreprise (SVG de préférence), ou un lien vidéo/audio optionnel.
  4. Contexte d'Utilisation : La page spécifique et l'emplacement (par ex., Spotlight Héro, grille multi-cartes, citation latérale).
  5. Marqueurs de Confiance : Détails vérifiables (par ex., lien vers l'étude de cas originale, statut "Client Vérifié", ou logo de plateforme tierce comme G2/Trustpilot).

Sorties

L'application de ce système produit :

  1. Spécification d'Anatomie : Positions relatives définies pour le texte de la citation, les guillemets, l'avatar, le nom, le titre, le logo et les marqueurs de confiance.
  2. Compositions de Mise en Page :
    • Spotlight Unique : Une mise en page à fort impact, pleine largeur ou demi-largeur pour les emplacements héros.
    • Grille/Cartes de Témoignages : Une grille asymétrique ou structurée de cartes pour afficher plusieurs témoignages.
    • Citation Intégrée : Citation compacte alignée latéralement, intégrée dans du contenu éditorial long.
  3. Plan de Balisage Sémantique : Structure HTML standardisée utilisant <figure>, <blockquote> et <figcaption> pour garantir une interprétation correcte par les lecteurs d'écran.
  4. Règles de Hiérarchie Typographique : Directives concernant le poids, l'interlignage, le style (limiter l'abus d'italique) et le contraste d'échelle entre la citation et les métadonnées de mention de source.

Flux de Travail

1. Auditer et Structurer l'Anatomie de la Citation

Chaque témoignage se compose de trois zones distinctes qui doivent être structurées dans le DOM et la feuille de style :

┌─────────────────────────────────────────────────────────┐
│  [1] Conteneur de Citation (avec blockquote sémantique) │
│      "Depuis le déploiement de SentryFlow, nous avons   │
│       réduit nos frais de préparation d'audit de 80 %." │
├─────────────────────────────────────────────────────────┤
│  [2] Zone de Mention de Source (avec figcaption sém.)   │
│      (👤 Avatar)  Jean Dupont                           │
│                   VP Conformité chez SentryCorp         │
├─────────────────────────────────────────────────────────┤
│  [3] Marqueur de Confiance/Vérification                 │
│      (✓ Client Vérifié)   [Logo SentryCorp]             │
└─────────────────────────────────────────────────────────┘
  • La Citation : La déclaration qualitative principale. Limiter la longueur à 2–3 phrases (environ 40–60 mots).
  • La Mention de Source : Le nom, le titre et l'organisation de l'auteur.
  • L'Ancre Visuelle : Une photo (avatar) ou un logo de marque pour attirer le regard et humaniser la citation.

2. Choisir le Motif de Mise en Page Spatiale

En fonction de la densité d'information et de la priorité visuelle, sélectionnez l'une des mises en page suivantes :

  • Motif Spotlight Héro :

    • Quand : Pages d'atterrissage à fort impact ou héros d'études de cas.
    • Mise en page : Centrée ou divisée horizontalement 50/50. Typographie massive à fort contraste (--text-xl ou --text-xxl).
    • Utilisation : Exactement un témoignage en spotlight par section de page pour éviter la dilution.
  • Grille de Cartes de Témoignages :

    • Quand : Sections dédiées à la "Preuve Sociale" ou aux "Ce que disent nos clients".
    • Mise en page : Grille responsive à 2 ou 3 colonnes.
    • Utilisation : Idéal lorsque vous avez 3 à 6 citations de haute qualité. Utilisez des hauteurs variables (ou un arrangement de type Bento) pour rendre la page plus organique.
  • Citation Intégrée :

    • Quand : Dans des études de cas longues, des articles ou des billets de blog.
    • Mise en page : Marges indentées, surlignage actif de la bordure gauche, flottant ou intégré dans des colonnes de paragraphes.
    • Utilisation : Pour diviser des blocs de texte denses et mettre en valeur les citations clients importantes.

3. Établir la Hiérarchie Typographique

Pour garantir la scannabilité (les utilisateurs scannent avant de lire) :

  • Style de la Citation : Évitez de styliser l'intégralité de la citation dans une police italique fine, gris clair. L'italique sur des blocs de texte de plus de quelques mots réduit la lisibilité. Utilisez plutôt un style de police normal avec une taille légèrement plus grande (--font-size-lg) ou une police à empattement expressive, et définissez-la dans une couleur neutre à fort contraste.
  • Indication de Citation Directe : Utilisez des pseudo-éléments CSS (::before/::after) pour afficher les guillemets décoratifs, ou positionnez un grand guillemet d'arrière-plan à faible opacité derrière le bloc. N'encodez pas en dur les guillemets littéraux " dans le texte pour éviter que les lecteurs d'écran ne les annoncent deux fois.
  • Contraste de la Mention de Source : Le nom de l'auteur doit être en gras (font-weight: 600), et son rôle/entreprise doit être stylisé dans une couleur secondaire atténuée (color: var(--text-muted)) avec une taille de police plus petite (--font-size-sm).

4. Intégrer les Indicateurs de Confiance et de Vérification

Pour contrer le scepticisme envers les "faux témoignages" :

  • Visuels Réels : Privilégiez toujours les photos professionnelles réelles aux avatars génériques, illustrations de stock ou espaces réservés vides.
  • Intégration du Logo : Placez le logo de l'entreprise du client à côté de son titre pour emprunter l'autorité de la marque.
  • Badges de Vérification : Si vous tirez parti d'une source tierce vérifiée (par ex., G2, Capterra), incluez une petite icône de marque indiquant l'origine.

5. Appliquer les Adaptations Responsives

Configurez les règles de redimensionnement et d'empilement fluides :

  • Réduction Mobile : Tous les témoignages spotlight horizontaux (50/50) doivent s'effondrer en une seule colonne verticale sur les écrans de moins de 768px, en plaçant la photo/logo visuelle en dessous du texte de la citation pour garder la déclaration de valeur proéminente.
  • Changements de Mise en Page en Grille : Les grilles de témoignages multi-colonnes doivent passer à un empilement à une seule colonne sur mobile. Ne forcez pas les utilisateurs à faire défiler horizontalement de petites cartes, sauf si vous implémentez un carrousel à balayage tactile.
  • Commandes de Carrousel (Si Utilisé) : Les motifs de carrousel doivent prendre en charge les gestes tactiles standard, les flèches du clavier (Gauche/Droite), et contenir des commandes de pause/lecture très visibles si la lecture automatique est activée (fortement déconseillée).

6. Assurer l'Accessibilité WCAG AA

  • Structure Sémantique : Enveloppez toujours l'ensemble du composant dans un élément <figure>. Enveloppez le texte de la citation dans un <blockquote> et la mention de source dans un <figcaption> contenant un <cite> pour le titre ou l'entreprise de l'auteur.
  • Contraste des Couleurs : Testez tous les éléments. Le texte de la citation et les mentions de source doivent maintenir un rapport de contraste d'au moins 4,5:1. Les éléments décoratifs (comme les grands guillemets d'arrière-plan) doivent avoir un faible contraste ou être cachés aux technologies d'assistance avec aria-hidden="true".
  • Clavier et Focus : Si les témoignages résident dans un panneau à onglets ou un curseur, tous les indicateurs de contrôle (points, flèches) doivent avoir des contours :focus-visible très visibles et répondre aux tailles minimales des cibles tactiles.

Règles de Décision

Matrice de Sélection de Mise en Page

Volume de ContenuEmplacement CiblePrioritéMotif Recommandé
1 Citation CléHéro / CTA PrincipalÉlevéeSpotlight Héro (Centré/Grand)
3–6 CitationsFonctionnalités / Zone de PreuveMoyenneGrille de Cartes de Témoignages (Asymétrique ou Bento)
6+ CitationsCentre de Réussite ClientHaute densitéGrille à Onglets Catégorisée ou Cartes à Chargement Progressif Tronquées
Copie ÉditorialeCorps d'Étude de Cas / BlogContextuelleCitation Intégrée (Indentée, bordure d'accentuation gauche)

Priorité Photo vs Logo

  • Utiliser les Photos Quand : La connexion émotionnelle humaine est primordiale (B2C, coaching personnel, plateformes de créateurs, applications grand public individuelles).
  • Utiliser les Logos d'Entreprise Quand : La crédibilité d'entreprise et l'autorité institutionnelle sont les moteurs principaux (SaaS B2B, services B2B, produits industriels).
  • Utiliser les Deux Quand : Vous présentez un argumentaire à des parties prenantes B2B de grande valeur où à la fois le persona d'acheteur spécifique (par ex., CTO) et sa marque d'entreprise ont un poids considérable.

Contraintes

  • Accessibilité :
    • Balisage sémantique : <figure>, <blockquote>, <figcaption>, <cite>.
    • Contraste : Minimum 4,5:1 sur tout texte lisible.
    • Lecteurs d'écran : Les pseudo-éléments de guillemets décoratifs cachés via CSS ou aria-hidden="true".
    • Focus : Le focus ne doit jamais être piégé ou obscurci dans les curseurs.
  • Responsivité :
    • Contrainte de largeur absolue du conteneur mobile : Ne jamais dépasser 100vw.
    • Cibles tactiles pour les commandes de curseur : Minimum 24x24px (WCAG 2.2 SC 2.5.8), préféré 44x44px.
    • Retour à la ligne du texte : Les noms ou titres longs doivent s'enrouler gracieusement sans être coupés.
  • Hiérarchie Visuelle :
    • La taille du texte de la citation doit être au moins 120 % de la taille du texte du corps dans les mises en page Spotlight.
    • Maintenez les guillemets décoratifs à une faible opacité (par ex., opacity: 0.1 à 0.2) pour éviter qu'ils n'entrent en collision ou ne chevauchent le texte.

Schémas d'Échec Courants

  • L'Erreur du "Mur d'Italiques" : L'italique réduit la vitesse de lecture et augmente la charge cognitive. Définir une citation de 100 mots entièrement en italique gris à faible contraste garantit que les utilisateurs la sauteront complètement.
  • Anonymat et Éléments de Stock : Les citations attribuées à "John D." ou accompagnées de photos de stock évidentes de mannequins souriants semblent fausses et nuisent gravement à la crédibilité du site.
  • Le Piège du "Trop Décoratif" : Rendre les guillemets CSS si grands et à fort contraste qu'ils obscurcissent les premières ou dernières lettres de la citation réelle, ou chevauchent l'avatar de l'orateur sur les écrans mobiles.
  • Blocage du Défilement Horizontal : Forcer les utilisateurs mobiles à balayer horizontalement pour lire les témoignages sans indicateur visuel de débordement (par ex., cartes qui dépassent) ou indicateurs à puces de repli accessibles.
  • Esthétique au Détriment de l'Accessibilité (Soupe de Div Sémantique) : Structurer les témoignages en utilisant un emballage <div> arbitraire sans balises sémantiques standards, empêchant les lecteurs d'écran d'annoncer le passage comme une citation.

Critères de Validation

  • Balisage Sémantique : Le HTML utilise <figure> comme conteneur, <blockquote> pour le texte, et <figcaption> pour les détails de l'attribution.
  • Vérification du Contraste : Le texte de la citation, le nom de l'orateur et le titre de l'orateur ont tous un rapport de contraste d'au moins 4,5:1.
  • Transition Responsive : Les mises en page Spotlight s'empilent verticalement sur les écrans < 768px, et les grilles multi-colonnes se réduisent à 1 colonne.
  • Lisibilité Typographique : Le texte du corps de la citation est défini dans un style de police normal/romain, évitant les longs blocs d'italique.
  • Aucun Caractère de Guillemet Encodé en Dur : Les guillemets sont rendus à l'aide de motifs d'arrière-plan CSS décoratifs ou de pseudo-éléments (::before/::after) avec content: "" et du style, ou cachés des lecteurs d'écran.
  • Espacement Proportionnel : L'espacement entre le corps de la citation et le bloc de mention de source utilise une variable relative cohérente (par ex., margin-top: var(--space-m)).
  • Authenticité Visuelle : L'attribution comprend des informations d'identification vérifiables (nom complet, titre, entreprise ou logo) et évite les graphiques de substitution.

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