Système de design GCComposants
Système de design GC Démarrer Aperçu des modèles de pagePage de base Aperçu des composantsAlerteAvisBarre de navigation latéraleBarre de navigation supérieureBascule de langueBoutonBoutons radioCarteCases à cocherChamp de dateChamp de saisieChemin de navigationConteneurDate de modificationDétailsEn-têteGrilleIcôneIndicateur d'étapeJeu de champsLienMasquage accessibleMenu thématiqueMessage d'erreurPaginationPied de pageRechercheRésumé des erreursSélectionSignatureTableauTéléverseur de fichiersTexteTitreZone de texte Aperçu des raccourcis CSS Réinitialisation des styles Mise en page réactiveÉtat Dimensionnement de la boîteDimensionnement du conteneurAffichageDébordementPositionVisibilité PoliceFamille de policeTaille de policeStyle de policeÉpaisseur de policeHauteur de ligneCouleur de lienTaille de lienDécoration de texte de lienStyle de listeAlignement de texteCouleur de texteDébordement de texteTransformation de texteSaut de mot MargeMarge intérieure Alignement de contenuAlignement des élémentsAlignement individuelÉlément flexibleDirection de l’élément flexibleÉlargissement de l’élément flexibleRétrécissement de l’élément flexibleHabillage de l’élément flexibleDégagementColonnes de grilleLignes de grilleJustification de contenuJustification des élémentsJustification individuelleOrdreAgencement de contenuAgencement des élémentsAgencement individuel Couleur de l'arrière-planCouleur de la bordureRayon de la bordureStyle de la bordureLargeur de la bordure Noms des icônesTaille de l'icôneImage CurseurÉvénements de pointeurTransition Aperçu des stylesUnités de styleCouleurEspacementTypographie Nous contacterS'impliquerTrouvez 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.
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.
  • Choisissez des valeurs de code pour obtenir l'élément que vous voulez.
  • Obtenez le code et intégrez-le dans votre environnement.
  • 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
2025-05-06