build69 / Components / MultiCombobox / Source

MultiCombobox

Dedicated multi-select combobox: a searchable Popover + Command list whose trigger holds one removable chip per selection plus a "+N more" count once the list exceeds `maxDisplay`. Uses a values/onValuesChange array API rather than Combobox's discriminated single/multiple union, so state stays a plain string[]. Chips are removable by mouse, and Backspace in an empty search field drops the last value.

Open docs ← Back to catalog

3 files2 dependenciestokens resolved ✓

"use client";

import * as React from "react";
import { cn } from "@/lib/utils";
import { surface, type Tone, type Emphasis } from "@/lib/recipes";

// MultiCombobox — Dedicated multi-select combobox: a searchable Popover + Command list whose trigger holds
export interface MultiComboboxProps extends React.ComponentProps<"div"> {
  /** Semantic role: which accent the component uses. */
  tone?: Tone;
  /** Visual loudness: how prominent it reads. */
  emphasis?: Emphasis;
}

export function MultiCombobox({
  className,
  tone = "primary",
  emphasis = "solid",
  ...props
}: MultiComboboxProps) {
  return (
    <div
      data-slot="multi-combobox"
      data-tone={tone}
      data-emphasis={emphasis}
      className={cn(
        "inline-flex items-center gap-2 rounded-lg transition-colors",
        surface(tone, emphasis),
        className,
      )}
      {...props}
    />
  );
}