reopt design
DocsExploreTemplatesCanvasToolsPricing
Login
opt-uiopt-chartsopt-datagridopt-editoropt-calendaropt-filemanageropt-chatopt-shellbrandapp-ui
Overview205Core74Shells99Blocks32
FilterBar
reopt designreopt design

A design system for the AI era

  • Docs
  • Pricing
  • Releases
  • About
  • Contact
  • Terms of Service
  • Privacy Policy

reopt Inc.Business registration no. 217-88-02453contact@reopt.ai

© 2026 reopt Inc. All rights reserved.

FilterBar

Shell

Filter a view with search, single-selection, and multiple-selection controls.

filter
Related docs
bun add @reopt-ai/opt-ui
Install and import
bash
bun add @reopt-ai/opt-ui
tsx
import { FilterBar } from "@reopt-ai/opt-ui";

Live preview

Change the width and theme, then interact with the components.

100%

라벨이 있는 필터 패널

검색 필터만

Usage guidance

Best practices

  • Keep filter IDs stable and update the relevant value in onFilterChange. Reset both applied values and query criteria in onClearAll.

Usage to avoid

  • Changing filter UI does not query server data automatically. The host connects asynchronous requests and error handling.

Usage examples

Filter bar

FilterBar

PropTypeDefaultDescription
childrenReactNode—기간 등 커스텀 조회 컨트롤
appliedFiltersReactNode—적용된 검색 조건
summaryReactNode—검색 결과 또는 조회 안내
layout"inline" | "panel""inline"패널은 보이는 라벨·배경·반응형 필드 배치를 제공
filtersFilterGroupDef[]—필터 그룹 배열. { id, label, type, options?, value? }
onFilterChange(filterId: string, value: string | string[] | boolean) => void—필터 변경 핸들러
onClearAll() => void—모든 필터 초기화 핸들러

컴포넌트 의존 관계

깊이
▲ USED BY (11)▼ USES (6)user-exploreracquisition-analysisfunnel-analysisbreakdown-analysispath-analysiscohort-comparisoncustom-dashboarddebug-workspacevisual-diff-manageruser-detailtask-dashboardFilterBarselectinputbuttonswitchcheckboxdate-range-picker
View test results

테스트 커버리지

2026년 7월 9일6/6 통과
6성공
0실패
6전체
  • 검색 필터를 렌더링한다
  • select 필터를 렌더링한다
  • multi-select 필터를 렌더링한다
  • 검색 필터 변경 시 onFilterChange를 호출한다
  • 필터가 활성화되면 초기화 버튼을 표시한다
  • 초기화 버튼 클릭 시 onClearAll을 호출한다

Blocks that use this component

opt-ui

AcquisitionAnalysis

Blocks

Analyze acquisition across Overview, Channels, and Campaigns tabs with metrics, trends, and tables.

opt-ui

BreakdownAnalysis

Blocks

Explore Trend, Distribution, Composition, and Data tabs with multiple charts and a DataTable.

opt-ui

CohortComparison

Blocks

Compare up to five cohorts across four tabs with comparison charts, retention heatmaps, and tables.

opt-ui

CustomDashboard

Blocks

Arrange custom dashboard widgets with WidgetGrid, ReportBuilder, ReportWidget, and FilterBar.

opt-ui

DebugWorkspace

Blocks

Debug E2E tests with a test-list sidebar and tabs for video, screenshots, network, console, and traces.

opt-ui

FunnelAnalysis

Blocks

Define funnel steps and compare conversion, breakdowns, and trends with charts and tables.

opt-ui

PathAnalysis

Blocks

Configure user-path analysis and explore grid or Sankey flows, top paths, drop-off, patterns, entry and exit points, and dwell time.

opt-ui

TaskDashboard

Blocks

Manage tasks with activity, team members, quick actions, and filters.

opt-ui

UserDetail

Blocks

Build user profiles with avatars, metrics, gauges, progress indicators, tables, and filters.

opt-ui

UserExplorer

Blocks

Explore user records with a DataTable and FilterBar.

opt-ui

VisualDiffManager

Blocks

Review screenshot regressions and approvals with a three-column snapshot list and image-diff viewer.

Related components

opt-ui

SearchCombobox

Shells

Search options with match-sorter fuzzy matching in a combobox.

opt-ui

SegmentBuilder

Shells

Define event, property, cohort, or custom segments with accessible condition controls.

opt-ui

AsyncCombobox

Shells

Search asynchronously with built-in debouncing, loading feedback, and stale-response protection.

opt-ui

ColumnToggler

Shells

Choose visible table columns from a popover of checkboxes.

opt-ui

BulkActions

Shells

Act on selected items with a count badge, action dropdown, and clear-selection button.

opt-ui

SavedFilters

Shells

Save and browse filter presets with keyboard navigation and deletion confirmation in a popover.

PreviousActivityFeedNextQuickActions