Velocity X Components

Carousels & Tickers

Category Pill Scroller

Horizontally scrollable filter pill row with edge-fade masks, conditional nudge arrows and roving-tabindex keyboard navigation.

Subscription Included with the Velocity Components subscription.
bash
$ velocityx add category-pill-scroller

Built for react. Needs react, react-dom already installed as peer dependencies. An Astro-only project needs @astrojs/react wired up first — this won't run on its own in plain Astro.

Full docs for Category Pill Scroller →

Needs a licence key — subscribe here, then velocityx loginonce.

react v1.0.0 react react-dom
Category Pill Scroller

Props

NameTypeRequiredDefaultDescription
categories{ label, value }[]No[]
defaultActivevalue of the initially active category (uncontrolled)Yes
activevalue of the active category (controlled)Yes
onChange(value) => voidYes

File this creates

The CLI writes this path into your project, relative to its root — nothing else moves.

text
components/velocity/category-pill-scroller/CategoryPillScroller.jsx

Using the Category Pill Scroller component

Install it with velocityx add category-pill-scroller. The CLI writes the source straight into your project — no runtime dependency, no registry lock-in, and it themes itself from the same primary-*/accent-* scale as the rest of the library.

More from Carousels & Tickers.