merisia-error-summary
<merisia-error-summary>
Résumé des erreurs de formulaire accessible. Reçoit le focus programmatique
(el.focus()) pour satisfaire WCAG 2.4.3. Les erreurs avec
field génèrent des liens vers les champs concernés.
Import
import '@merisia-inc/merisia-components/error-summary';
import '@merisia-inc/merisia-components/input';
import '@merisia-inc/merisia-components/checkboxes';
Extension
Vous pouvez sous-classer ce composant pour ajouter ou redéfinir des propriétés, méthodes ou styles :
import { customElement } from 'lit/decorators.js';
import { MerisiaErrorSummary } from '@merisia-inc/merisia-components';
@customElement('my-error-summary')
export class MyErrorSummary extends MerisiaErrorSummary {
// Ajoutez ou redéfinissez des propriétés, méthodes ou styles ici.
}
Démos
Avec plusieurs erreurs (liens vers des composants merisia-inc)
const summary = document.getElementById('form-errors');
// Collecte automatique depuis le formulaire :
summary.collectFrom(document.querySelector('form'));
summary.focus();
// Ou manuellement :
summary.errors = [
{ message: 'Le prénom est requis.', field: 'demo-first-name' },
{ message: "L'adresse courriel est invalide.", field: 'demo-email' },
{ message: 'Vous devez accepter les conditions.' },
];
Propriétés
| Propriété | Attribut | Type | Défaut | Description |
|---|---|---|---|---|
| MerisiaErrorSummary (propres) | ||||
| title | title | string | 'Des erreurs ont été détectées dans le formulaire.' | Titre du résumé d'erreurs (i18n) |
| errors | – | ErrorSummaryItem[] | [] |
Liste d'erreurs : { message, field? } — field génère un
lien ancre (propriété JS uniquement)
|
| autoFocus | auto-focus | boolean | false | Déplace le focus sur le résumé à chaque mise à jour avec des erreurs |
| MerisiaElement (hérités) | ||||
| id | id | string | auto-généré | Identifiant unique du composant |
| lang | lang | string | 'fr' | Langue pour les messages internes (i18n) |
| width | width | number | – |
Largeur maximale en caractères : max-width: calc(N ch + 1.5rem)
|