id: form_error_summary
label: Form Error Summary
family: family-c-forms
category: Form
intent: Summarize form validation errors
description: Form validation error summary
composable: false
capabilities:
required_parts: []
optional_parts: []
tags: ["form-error-summary", "error", "validation", "form", "summary"]
keywords:
pain: Form errors scattered and not announced collectively
promise: All form errors announced together with structured summary
why: |
FormErrorSummaryPrimitive uses role="alert" with aria-atomic to ensure full error announcement. Errors are grouped and structured. This guarantees accessibility and visibility of all validation issues.
rules: ["CR-001", "CR-004"]
use_cases: ["form validation", "multi-field errors"]
related: ["form", "input", "input_group", "input_otp", "textarea", "field", "label", "checkbox"]
file: form_error_summary_ui.css
tokens: form-error-summary-*, space-*, font-*, radius-*
foundation: spacing, radius, typography
states: ["error"]
island: form_error_summary_boundary.rs
pillar: form
badges: ["SSR Safe", "Hydration Safe", "Token Driven", "Deterministic API", "Zero Drift"]
before: |
// ❌ Typical
view! {
<div>"Error"</div>
}
after: |
// ✅ CanonRS
view! {
<FormErrorSummary errors=vec![] />
}
boundary_type: passthrough
block: []
blocks_primitives: [stack]