Empty state

The reason a region has nothing to show, with an available next action.

Create a demo project and the server replaces the empty state with content.

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 empty-state

Usage

html
{% import "suprnova-ui/empty-state/empty-state.html" as empty_state %}
{% call empty_state::empty_state("projects", "empty", "No projects", text="Create a project to get started.") %}{% endcall %}

Examples

No results

The server filters demo projects and offers a clear-filter action when none match.

Open in new tab

No permission

A read-only demo explains why content is unavailable and offers no create action.

Open in new tab

Keyboard and accessibility

suprnova.empty-state - the specific reason a region has nothing to show (FDB-003): empty, no-results, no-permission or disconnected, taken from server-rendered state. The caller renders a next action in the body only when the principal can take one; the view offers none of its own.

API reference

empty_state

ParameterDefaultDescription
idRequiredThe region's unique id, also used to associate its heading.
reasonRequiredThe server's reason: empty, no-results, no-permission or disconnected.
titleRequiredThe heading that names the empty condition.
text""Optional text explaining the condition or the next step.