Flash region

A region of outcome messages from an accepted request.

Save demo settings to show the result in this island, or clear its notice.

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 flash-region

Usage

html
{% import "suprnova-ui/flash-region/flash-region.html" as flash_region %}
{% call flash_region::flash_region("notices", messages) %}{% endcall %}

Examples

Timed notice

A region with a duration hides its notice after five seconds, held while the pointer or focus rests on it.

Open in new tab

Keyboard and accessibility

suprnova.flash-region - the outcome of the last accepted request, read once from the session by the page handler and rendered on the document that follows a redirect (FDB-004). A restored or reloaded document has nothing to show because the flash was consumed. Each message is an ordinary alert-shaped block announced politely from one region; the messages carry a variant and a text. A duration in milliseconds hides each message that long after it appears, held while the pointer or focus is on the region (sn-flash-region, flash-region.js); the default, 0, keeps every message until the next document. The element always wraps the region, so the view's structure is the same on every branch and a morph never moves the region; without a duration it does nothing.

API reference

flash_region

ParameterDefaultDescription
idRequiredThe status region's unique element id.
messagesRequiredOutcome messages, each with variant and text fields.
label"Notices"The accessible name of the notice region.
duration0Milliseconds before each message hides, held while the pointer or focus rests on the region; 0 keeps every message.