xxshna.ui
V 1.1.0Get started ↗

Validation summaries

Surface form-level problems together with links to affected controls.

Catalog · 1.1HTML, CSS & optional JSNo runtime dependencies

Live preview

Interactive exampleOpen playground ↗
HTML
<div class="xsh-validation-summary" role="alert">
<strong>Please correct the following</strong>
<ul>
<li>
<a href="#xsh-example-email">Work email is required</a>
</li>
<li>
<a href="#xsh-target-url">URL must include a scheme</a>
</li>
</ul>
</div>

Installation & markup

Include the local stylesheet and script once on the page, then place the component inside a data-xsh-ui root. The example above works without a build system.

<link rel="stylesheet" href="/dist/xshna-ui.css">
<div data-xsh-ui>
  <!-- Add the HTML example above -->
</div>
<script defer src="/dist/xshna-ui.js"></script>

Component API

Public classes, attributes and hooks used by this example. Keep the xsh- prefix intact.

IdentifierContract
xsh-validation-summaryUsed by the example markup and component styles or behavior.
role=alertUsed by the example markup and component styles or behavior.

Accessibility & keyboard

Native links are keyboard accessible. Provide real field IDs in production.

Implementation note. Connect summaries to actual invalid fields and keep errors updated.

Interaction contract

Behavioral components use the shared delegated runtime; visual-only primitives rely on semantic HTML and CSS. Runtime controls emit bubbling xsh:* CustomEvents; bind application handlers to those events when server persistence, API data or navigation is required.