Validation summary

The form-level list of one action's validation errors.

Submit the empty form: the server rejects both fields and the summary lists them.

Open in new tab

Each preview is its own Live page in a frame, because this site is a Vue 3.5 app built on the Pulsar starter kit. An open list or popover stays inside its frame; in your application it opens over the page.

Installation

bash
suprnova live:add validation-summary

Usage

html
{% import "suprnova-ui/validation-summary/validation-summary.html" as validation_summary %}
{% call validation_summary::validation_summary("register") %}{% endcall %}

Examples

Custom title

The same summary under its own heading.

Open in new tab

Keyboard and accessibility

suprnova.validation-summary - the form-level error list for one action. The section shows only while an entry shows: each entry is bound with live:error to its field and links to it, so the summary names the fields to correct without repeating every field message, and the last entry carries the action's own failure, announced politely. A form that nobody has submitted renders the summary hidden.

API reference

validation_summary

ParameterDefaultDescription
actionRequiredThe action whose validation errors the summary lists.
title"Please correct the following"The summary's heading.

summary_entry

ParameterDefaultDescription
nameRequiredThe field the entry follows: hidden until that field's validation fails, then a link to the field's `id`.
labelRequiredThe link text, the field's label.