Radio Filter

Single-select radio list with optional result counts. Clicking the active option clears the selection, so the filter is always escapable.

Fit

32
14
21

Installation

Adds the component and everything it depends on to your project.

npx shadcn add https://ui.beste.co/component/r-base/filter-radio

New here? Read the installation guide.

Usage

The import and the props worth knowing about, in one place.

import { FilterRadio } from "@/components/beste/component/filter-radio";

<FilterRadio
  label="Fit"
  defaultValue="regular"
  onChange={(value) => console.log("selected:", value)} // null when cleared
  options={[
    { label: "Regular", value: "regular", count: 32 },
    { label: "Oversized", value: "oversized", count: 14 },
  ]}
/>

Playground

Turn the props on the right; the snippet under them is what you would write to get what you see.

Fit

32
14
21
Usage
import { FilterRadio } from "@/components/beste/component/filter-radio";

<FilterRadio
  label="Fit"
  className="w-56"
  defaultValue="regular"
  options={[{"label":"Regular","value":"regular","count":32},{"label":"Oversized","value":"oversized","count":14},{"label":"Slim","value":"slim","count":21}]}
/>

Keyboard and gestures

Every one of these is in the component already. They are listed because a props table cannot mention a gesture, so nothing else on this page can tell you they exist.

Arrow keysMove through the options. A radio group is one tab stop, so the arrows are how you get around inside it.
SpaceTake the focused option.

Props

Read from the component's own type, so this cannot drift from what it accepts.

PropTypeDefaultDescription
labelstringOptional group heading rendered above the list
optionsFilterRadioOption[]
valuestring | nullControlled selection; omit to let the component manage its own state
defaultValuestringInitial selection when uncontrolled
allowClearbooleanClicking the active option clears the selection (default true)
onChange(value: string | null) => void
classNamestring

More Filter components

View all Filter

Category

Select Filter

Single-select dropdown for long option lists that would crowd a sidebar. Supports a clear item, result counts, and a disabled state for dependent filters.

Category

24
18
9
12

Checkbox Filter

Multi-select checkbox list with optional result counts. Works controlled or uncontrolled, designed for filter sidebars and toolbars.

Gender

Segmented Filter

Single-select segmented control built on Tabs for mutually exclusive choices like gender or condition. Clicking the active segment clears the selection.

Rating

Rating Filter

Star rows for minimum-rating filtering in the familiar n-and-up pattern. Clicking the active row clears the selection.

Size

Multiselect Filter

Dropdown with checkbox rows and a selection-count badge. Keeps many-option filters compact in toolbars where a checkbox list would not fit.

Price

to

Min/Max Range Filter

Paired number inputs for open-ended ranges: either side can stay empty, so users can filter by only a minimum or only a maximum.