Multiselect Filter

Size

About this component

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.

Usage

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

import { FilterMultiselect } from "@/components/beste/component/filter-multiselect";

<FilterMultiselect
  label="Size"
  placeholder="All sizes"
  defaultValue={["m"]}
  onChange={(value) => console.log("selected:", value)}
  options={[
    { label: "S", value: "s", count: 12 },
    { label: "M", value: "m", count: 28 },
    { label: "L", value: "l", count: 24 },
  ]}
/>

Playground

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

Size

Usage
import { FilterMultiselect } from "@/components/beste/component/filter-multiselect";

<FilterMultiselect
  label="Size"
  placeholder="All sizes"
  className="w-64"
  defaultValue={["m","l"]}
  options={[{"label":"XS","value":"xs","count":6},{"label":"S","value":"s","count":12},{"label":"M","value":"m","count":28},{"label":"L","value":"l","count":24},{"label":"XL","value":"xl","count":11}]}
/>

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.

TabMove between the boxes — each is its own control, not one list with an inner cursor.
SpaceTick or untick the focused one.

Props

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

PropTypeDefaultDescription
labelstringOptional group heading rendered above the trigger
optionsFilterMultiselectOption[]
valuestring[]Controlled selection; omit to let the component manage its own state
defaultValuestring[]Initial selection when uncontrolled
placeholderstringTrigger text while nothing is selected
disabledboolean
onChange(value: string[]) => void
classNamestring

More Filter components

View all Filter

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.

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.

Brand

Combobox Filter

Searchable dropdown for very long option lists like brands. Type to narrow options, select one or many, and see result counts inline.

Category

42
24
10
8
38
12

Tree Filter

Hierarchical checkbox tree for nested categories with expand/collapse rows. Checking a parent checks its whole subtree, and partially selected parents turn indeterminate.

Size

Chips Filter

Multi-select button chips for compact option sets like sizes. Works controlled or uncontrolled.

Deals

Toggle Filter

Switch rows for boolean product flags like on-sale or in-stock. Multi-select, works controlled or uncontrolled.