Multi-select checkbox list with optional result counts. Works controlled or uncontrolled, designed for filter sidebars and toolbars.
The import and the props worth knowing about, in one place.
import { FilterCheckbox } from "@/components/beste/component/filter-checkbox";
<FilterCheckbox
label="Category"
defaultValue={["sneakers"]} // uncontrolled initial selection
onChange={(value) => console.log("selected:", value)}
options={[
{ label: "Sneakers", value: "sneakers", count: 24 },
{ label: "T-Shirts", value: "t-shirts", count: 18 },
]}
/>
// Controlled: pass `value` and keep it in your own state
<FilterCheckbox
options={[{ label: "Sneakers", value: "sneakers" }]}
value={["sneakers"]}
onChange={(value) => console.log("selected:", value)}
/>Turn the props on the right; the snippet under them is what you would write to get what you see.
import { FilterCheckbox } from "@/components/beste/component/filter-checkbox";
<FilterCheckbox
label="Category"
className="w-56"
defaultValue={["sneakers"]}
options={[{"label":"Sneakers","value":"sneakers","count":24},{"label":"T-Shirts","value":"t-shirts","count":18},{"label":"Hoodies","value":"hoodies","count":9},{"label":"Accessories","value":"accessories","count":12}]}
/>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.
| Tab | Move between the boxes — each is its own control, not one list with an inner cursor. |
|---|---|
| Space | Tick or untick the focused one. |
Read from the component's own type, so this cannot drift from what it accepts.
| Prop | Type | Default | Description |
|---|---|---|---|
label | string | — | Optional group heading rendered above the list |
options | FilterCheckboxOption[] | — | |
value | string[] | — | Controlled selection; omit to let the component manage its own state |
defaultValue | string[] | — | Initial selection when uncontrolled |
onChange | (value: string[]) => void | — | |
className | string | — |
Dropdown with checkbox rows and a selection-count badge. Keeps many-option filters compact in toolbars where a checkbox list would not fit.
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.
Hierarchical checkbox tree for nested categories with expand/collapse rows. Checking a parent checks its whole subtree, and partially selected parents turn indeterminate.
Single-select radio list with optional result counts. Clicking the active option clears the selection, so the filter is always escapable.