reopt design
DocsExploreTemplatesCanvasToolsPricing
Login
opt-uiopt-chartsopt-datagridopt-editoropt-calendaropt-filemanageropt-chatopt-shellbrandapp-ui
Overview205Core74Shells99Blocks32
VirtualList
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.

VirtualList

Component

Render large lists efficiently by windowing visible items.

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

Live preview

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

100%

1,000개 항목 가상 스크롤

Item 1

VirtualList

PropTypeDefaultDescription
itemsRequiredT[]—렌더링할 항목 배열
renderItemRequired(item: T, index: number) => ReactNode—항목 렌더 함수
itemHeightRequirednumber—각 항목의 고정 높이(px)
overscannumber3뷰포트 밖에 미리 렌더링할 항목 수
View test results

테스트 커버리지

2026년 7월 9일4/4 통과
4성공
0실패
4전체
  • 항목을 렌더링한다
  • role=list를 가진다
  • 렌더된 윈도우 항목에 listitem 역할을 부여한다
  • 컨테이너 리사이즈 시 visible range를 다시 계산한다

Related components

opt-ui

Kbd

Core

Display keyboard shortcuts as inline key badges.

opt-ui

StatCard

Core

Show a metric with its value, change, and supporting description. Omit the change row when no comparison is available.

opt-ui

CompositeZone

Core

Navigate child elements in two dimensions with arrow keys using a Composite container.

opt-ui

Toolbar

Core

Group actions in a toolbar with buttons, separators, and tooltips.

opt-ui

Badge

Core

Display inline status badges with five color variants and an optional status dot.

opt-ui

Spinner

Core

Indicate loading in three sizes, with an aria-hidden mode for decorative use.

PreviousPaginationNextLoadingOverlay