Système de design GC Composants
Système de design GC Démarrer Aperçu des modèles de page Page de base Aperçu des composants Avis Barre de navigation latérale Barre de navigation supérieure Bascule de langue Bouton Boutons radio Carte Cases à cocher Champ de date Champ de saisie Chemin de navigation Conteneur Date de modification Détails En-tête Grille Icône Indicateur d'étape Jeu de champs Lien Masquage accessible Menu thématique Message d'erreur Pagination Pied de page Recherche Résumé des erreurs Signature Sélection Texte Titre Téléverseur de fichiers Zone de texte Aperçu des raccourcis CSS Réinitialisation des styles Mise en page réactive État Affichage Dimensionnement de la boîte Dimensionnement du conteneur Débordement Position Visibilité Alignement de texte Couleur de lien Couleur de texte Débordement de texte Décoration de texte de lien Famille de police Hauteur de ligne Police Saut de mot Style de liste Style de police Taille de lien Taille de police Transformation de texte Épaisseur de police Marge Marge intérieure Agencement de contenu Agencement des éléments Agencement individuel Alignement de contenu Alignement des éléments Alignement individuel Colonnes de grille Direction de l’élément flexible Dégagement Habillage de l’élément flexible Justification de contenu Justification des éléments Justification individuelle Lignes de grille Ordre Rétrécissement de l’élément flexible Élargissement de l’élément flexible Élément flexible Couleur de la bordure Couleur de l’arrière-plan Largeur de la bordure Rayon de la bordure Style de la bordure Image Noms des icônes Taille de l'icône Curseur Transition Événements de pointeur Aperçu des styles Unités de style Unités de style de couleur Unités de style d’espacement Unités de style typographie Nous contacter S’impliquer Trouver une démo

Résumé des erreurs
<gcds-error-summary>

Autres noms : liste d'erreurs.

Un résumé des erreurs consiste en une liste des erreurs rencontrées par les utilisateur·rice·s dans un formulaire.

  • GitHub
  • Figma

Aperçu du composant de résumé des erreurs

Sur cette page

Codage et accessibilité des messages d'erreur

Utiliser le résumé des erreurs avec les composants de Système de design GC

Tous les composants de Système de design GC sont livrés avec une gestion des erreurs par défaut pour les composants de formulaire requis. Dans le cas des résumés des erreurs, cela signifie que tout composant requis affichera un message d'erreur intercalé par défaut pendant l'événement onBlur. Ce message d'erreur sera indiqué dans le résumé des erreurs lors de l'envoi du formulaire.

Le résumé des erreurs de Système de design GC utilise l'attribut listen pour recueillir les erreurs. Lors de l'exécution de l'opération onSubmit, le résumé des erreurs dressera la liste des erreurs provenant des composants de Système de design GC. Les erreurs seront répertoriées dans le même ordre qu'elles apparaissent sur la page.

  • Activez tous les contrôles nécessaires pour résoudre l'une ou l'autre des erreurs.
  • Envisagez de remplacer tout message d'erreur générique par défaut par un texte qui définit le problème concret et la façon de le résoudre.

Utiliser le résumé des erreurs avec vos propres composants

Si vous utilisez certains de vos propres composants de formulaire :

  • Ajoutez un message d'erreur en faisant passer l'attribut error-links pour tout composant ou élément que vous utilisez contenant un message d'erreur. Vous verrez ensuite apparaître les messages d'erreur.
  • Associez le contenu de l'élément du résumé des erreurs à chacun des messages d'erreur.
  • Classez les erreurs du résumé des erreurs dans le même ordre qu'elles apparaissent sur le formulaire.

Choisir de modifier le contenu de l'entente d'erreur

Rédigez des en-têtes d'erreur plus précis en utilisant l'attribut heading.

Exemples Explorez les différentes façons de configurer le composant. Chaque exemple présente une mise en œuvre fonctionnelle et du code prêt à copier.

Dans cette section

Attributs facultatifs Ces attributs vous permettent de personnaliser ou d’enrichir le comportement et la présentation du composant.

L'attribut error-links définit la liste des erreurs à afficher dans le résumé des erreurs. Format : { link-href: link-label }.

<gcds-error-summary error-links='{ "#error-href-1": "Élément du résumé des erreurs.", "#error-href-2": "Élément du résumé des erreurs.", "#error-href-3": "Élément du résumé des erreurs." }'>
</gcds-error-summary>

heading

L'attribut heading définit le titre du résumé des erreurs.

<gcds-error-summary heading="Titre" error-links='{ "#error-href-1": "Élément du résumé des erreurs.", "#error-href-2": "Élément du résumé des erreurs.", "#error-href-3": "Élément du résumé des erreurs." }'>
</gcds-error-summary>

listen

L'attribut listen contrôle si le résumé des erreurs écoute l'événement gcdsError pour générer la liste des erreurs. Par défaut, il est défini à true.

<gcds-error-summary error-links='{ "#error-href-1": "Élément du résumé des erreurs.", "#error-href-2": "Élément du résumé des erreurs.", "#error-href-3": "Élément du résumé des erreurs." }' listen>
</gcds-error-summary>

Générateur de code

Générez une version du composant dont vous avez besoin en sélectionnant les propriétés de code correspondantes ou explorez les possibilités en choisissant différentes valeurs de code.

  1. Choisissez des valeurs de code pour obtenir l'élément que vous voulez.

  2. Obtenez le code et intégrez-le dans votre environnement.

  3. Ajoutez tout contenu nécessaire au composant (comme le texte du libellé).

Remarque : Conformément à la pratique courante, le générateur de code utilise l'anglais pour tous les éléments de code.

Aidez-nous à nous améliorer

Vous avez des questions ou des demandes? Faites-nous part de vos commentaires à l'aide de notre formulaire de contact.

Quelque chose ne va pas? Signalez-le sur GitHub en créant un compte. Vous pourrez accéder aux réponses de l'équipe, suivre les progrès réalisés concernant votre problèmes et voir les problèmes signalés par d'autres personnes.

Fournir des commentaires Signaler un problème sur GitHub
2026-05-27