コンポーネント一覧へ戻る

これは何か
件数付きのフィルターチップを横一列に並べます。選んだチップは黒く塗られ、ラベルの横にチェックが滑り込みます。multiple を渡すと複数を同時に選べます。選択肢を差し替えて、一覧やギャラリー、検索結果の上にそのまま置けます。
TSX の全文です。アカウントは不要です。
filter-chip-row.tsx
"use client"; import * as React from "react";import { Check } from "lucide-react";import { cn } from "@/lib/utils"; export type FilterChipOption = { value: string; label: string; /** Optional result count shown after the label. */ count?: number;}; export const FILTER_CHIP_DEFAULT_OPTIONS: readonly FilterChipOption[] = [ { value: "all", label: "All", count: 128 }, { value: "design", label: "Design", count: 42 }, { value: "engineering", label: "Engineering", count: 37 }, { value: "marketing", label: "Marketing", count: 21 }, { value: "sales", label: "Sales", count: 16 },]; export type FilterChipRowProps = Omit< React.ComponentPropsWithoutRef<"div">, "onChange" | "defaultValue"> & { options?: readonly FilterChipOption[]; /** Selected values. With `multiple={false}` it holds at most one value. */ value?: readonly string[]; defaultValue?: readonly string[]; /** Allow several chips at once. Single mode always keeps one chip selected. */ multiple?: boolean; onValueChange?: (value: string[]) => void; ariaLabel?: string;}; const EASE = "cubic-bezier(0.22, 1, 0.36, 1)"; export const FilterChipRow = React.forwardRef<HTMLDivElement, FilterChipRowProps>( ( { options = FILTER_CHIP_DEFAULT_OPTIONS, value, defaultValue, multiple = false, onValueChange, ariaLabel = "Filters", className, ...props }, ref, ) => { const items = options.length > 0 ? options : FILTER_CHIP_DEFAULT_OPTIONS; const [uncontrolled, setUncontrolled] = React.useState<string[]>(() => [ ...(defaultValue ?? (items[0] ? [items[0].value] : [])), ]); const selected = value ?? uncontrolled; const chips = React.useRef<(HTMLButtonElement | null)[]>([]); const commit = (next: string[]) => { if (value === undefined) setUncontrolled(next); onValueChange?.(next); }; const toggle = (itemValue: string) => { const isOn = selected.includes(itemValue); if (!multiple) { if (!isOn) commit([itemValue]); return; } commit(isOn ? selected.filter((v) => v !== itemValue) : [...selected, itemValue]); }; const onKeyDown = (event: React.KeyboardEvent<HTMLDivElement>) => { if (event.key !== "ArrowRight" && event.key !== "ArrowLeft") return; const current = chips.current.findIndex((node) => node === document.activeElement); if (current < 0) return; event.preventDefault(); const step = event.key === "ArrowRight" ? 1 : -1; const next = (current + step + items.length) % items.length; chips.current[next]?.focus(); }; return ( <div ref={ref} role="group" aria-label={ariaLabel} data-tsuna-id="filter-chip-row" data-multiple={multiple ? "" : undefined} onKeyDown={onKeyDown} className={cn( "flex max-w-full gap-2 overflow-x-auto px-1 py-1 [scrollbar-width:none] [&::-webkit-scrollbar]:hidden", className, )} {...props} > {items.map((item, i) => { const on = selected.includes(item.value); return ( <button key={item.value} ref={(node) => { chips.current[i] = node; }} type="button" aria-pressed={on} onClick={() => toggle(item.value)} className={cn( "inline-flex h-9 shrink-0 cursor-pointer items-center rounded-full border-0 px-3.5", "text-[13.5px] leading-none font-medium tracking-[-0.01em] whitespace-nowrap", "transition-[background-color,color,box-shadow,transform] duration-300 active:scale-[0.96]", "motion-reduce:transition-none motion-reduce:active:scale-100", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-zinc-900/40 focus-visible:ring-offset-2 focus-visible:ring-offset-[#e8eaed]", on ? "bg-zinc-950 text-white shadow-[0_8px_18px_-10px_rgba(15,23,42,0.6)]" : "bg-white text-zinc-700 shadow-[inset_0_0_0_1px_rgba(15,23,42,0.08)] hover:bg-zinc-50 hover:text-zinc-950", )} > <span aria-hidden className="grid overflow-hidden motion-reduce:!transition-none" style={{ gridTemplateColumns: on ? "1fr" : "0fr", marginRight: on ? 6 : 0, opacity: on ? 1 : 0, transition: `grid-template-columns 380ms ${EASE}, margin 380ms ${EASE}, opacity 260ms ${EASE}`, }} > <span className="min-w-0"> <Check className="size-3.5" strokeWidth={2.8} /> </span> </span> {item.label} {item.count !== undefined ? ( <span className={cn( "ml-1.5 text-[12px] tabular-nums transition-colors duration-300 motion-reduce:transition-none", on ? "text-white/60" : "text-zinc-400", )} > {item.count} </span> ) : null} </button> ); })} </div> ); },); FilterChipRow.displayName = "FilterChipRow";コンポーネント
フィルターチップ列
件数付きのフィルターチップを横一列に並べます。選んだチップは黒く塗られ、ラベルの横にチェックが滑り込みます。multiple を渡すと複数を同時に選べます。選択肢を差し替えて、一覧やギャラリー、検索結果の上にそのまま置けます。
Verified Technical Spec
- アニメーション
- CSS / Tailwind
- Reduced motion
- 確認済み
- キーボードフォーカス
- 確認済み
- 対応環境
- Tailwind CSS v3.4 + v4 · React 19 / Next.js 15 App Router + Vite / Remix 対応
含まれるもの
- ソースを Cursor / Claude に渡してエージェントに組み込める
- React · TypeScript · Tailwind CSS · Lucide の完成 UI
依存パッケージ
- React 19.0.0
- Typescript 5.7.2
- Tailwindcss 3.4.16
- Lucide-react 1.23.0
技術スタック
- React
- TypeScript
- Tailwind CSS
- Lucide
バージョン 1.0.0





