List-page filter strip: search field, filter controls, reset affordance and trailing actions.

npx slipstream-ui@latest add filter-bar
List filters (interactive)

query: — · status: all

Props

PropTypeDefaultDescription
searchValuestring—Controlled search text.
onSearchChange(value: string) => void—Fires on each keystroke; hides the search box when omitted.
searchPlaceholderstring'Search…'Search placeholder (also its accessible name).
onReset() => void—Shows a reset button when provided.
activeCountnumber0Active filter count appended to the reset label.
trailingReactNode—Far-right actions (bulk actions, column settings).

Accessibility

  • role=search wraps the controls; the search input is labelled by its placeholder.
  • Reset is a normal button with an updated accessible name.

Browser support

BrowserTested versions
Chrome111+ (Mar 2023)
Edge111+ (Mar 2023)
Firefox121+ (Dec 2023)
Safari17.2+ — macOS & iOS (Dec 2023)

Slipstream components rely only on CSS custom properties, Flexbox/Grid, and ARIA — the everyday baseline of the last two years of evergreen releases. Anything newer is progressive enhancement: unsupported browsers keep full functionality with static behavior instead of animations.

Was this page helpful?