Search input

A search input whose model updates are debounced by 250 ms.

The server filters a list of Suprnova subsystems as you type.

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 search-input

Usage

html
{% import "suprnova-ui/search-input/search-input.html" as search_input %}
{% call search_input::search_input("query", value=query) %}{% endcall %}

Examples

Result count

The server reports how many subsystems match.

Open in new tab

Keyboard and accessibility

suprnova.search-input - a search input whose model binding is debounced (FORM-003): the server sees a settled query, not every keystroke. value is the island's current query (FORM-009), and authority marks a server correction (Live spec 12). control_id separates the field name from its DOM identity when the same model field is mounted in several islands. combobox exposes the input's listbox relationships before enhancement.

API reference

search_input

ParameterDefaultDescription
nameRequiredThe model field. Its updates are debounced by 250 ms, so declare it `#[model(debounce = 250)]`.
placeholder"Search"Placeholder text.
value""The island's current value of the field, so the control shows it.
authority""A correction sequence. When set, this render replaces the visitor's unsent edit.
comboboxfalseWhen true, the input carries `role="combobox"` and points at its `<control_id>-listbox`, so a results list beside it is announced before the island enhances.
control_idnameThe input's DOM id, defaulting to `name`. Give each island its own when the same model field is mounted more than once on a page.