Skip to main content
196

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Web docs
Data display

FilterBar

Composes dashboard filtering, active criteria, and result announcements without owning queries.

FrameworksAstro · React · Elements

Registry commandlumen add FilterBar

InteractionNative markup

01

See it and copy it

Framework example

Choose Astro, React, or Elements to compare native usage against the shared visual output. Each example assumes the framework-level setup is already complete.

AstroCode target · live preview uses Astro
Filters

12 matching records

View FilterBar code

Framework usage

Switch targets to compare the adapter code. This live preview runs the Astro example. React and Elements use their own behavior APIs; complete the matching framework setup before copying an example.
astro
---
import { Button, Field, FilterBar, Label, NativeSelect, SearchField } from '@santi020k/lumen-astro'
---

<FilterBar label="Filters" resultLabel="12 matching records">
  <Field><Label for="filter-search">Search</Label><SearchField id="filter-search" placeholder="Search records" /></Field>
  <Field><Label for="filter-status">Status</Label><NativeSelect id="filter-status"><option>Active</option><option>All</option></NativeSelect></Field>
  <Button slot="active" variant="outline" size="sm" aria-label="Remove status: Active">Status: Active ×</Button>
  <Button slot="actions" variant="ghost" size="sm">Reset filters</Button>
</FilterBar>
Edit FilterBar in browser
02

Choose your target

Add this component

Choose the package for your runtime. All adapters share the Lumen stylesheet. Use the matching registry command when you want a local wrapper for that framework.

bash@santi020k/lumen-astro
pnpm add @santi020k/lumen-astro
pnpm add @santi020k/lumen-astro
bashAstro wrapper
lumen add FilterBar
lumen add FilterBar

API reference

Lumen-specific props and runtime attributes for the Astro primitive. Use the framework differences above and the copyable examples for React composition and Elements attributes; the public adapter types define their supported contracts.

AttributeValuesDefaultDescription
label, resultLabelstringFilters, optionalNames filters and announces a complete localized result count.
pending, openbooleanfalse, trueMarks pending results and controls the native disclosure.
default slot, active slot, actions slotcontentoptionalComposes public search/select controls, removable filters, and reset actions. The application owns requests and persistence.
class, classNamestring""Merges custom classes with the generated ui-* root classes.
...native attributesHTML attributes-Forwards standard attributes to the root element unless the component consumes them.

Web docsFull catalog