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

LoadingOverlay

Component

Overlay a loading state with one aria-busy live region and no duplicate status announcements.

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

Live preview

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

100%

기본 사용

콘텐츠 영역

이 영역 위에 로딩 오버레이가 표시됩니다.

Usage guidance

Best practices

  • Connect loading when refreshing existing content, and describe the ongoing task with label.

Usage to avoid

  • An overlay does not necessarily block keyboard access. Disable underlying controls too when duplicate actions must be prevented.

Usage examples

Refresh indicator that preserves existing results

LoadingOverlay

PropTypeDefaultDescription
loadingRequiredboolean—로딩 상태
childrenRequiredReactNode—감싸는 콘텐츠
labelstring"Loading…"로딩 텍스트

컴포넌트 의존 관계

깊이
▲ USED BY (26)▼ USES (1)sql-workspacealert-managerretention-analysisbilling-pageproject-settingsanalytics-dashboardrealtime-dashboardsegment-manageruser-exploreracquisition-analysisfunnel-analysisbreakdown-analysiscohort-comparisoncustom-dashboarddebug-workspacevisual-diff-managertest-analyticsuser-detailinsights-dashboardproject-overviewdata-explorerproject-dashboardsettings-paneltask-dashboarddeployment-centerchat-assistantLoadingOverlayspinner
View test results

테스트 커버리지

2026년 7월 9일3/3 통과
3성공
0실패
3전체
  • loading=false일 때 콘텐츠만 표시한다
  • loading=true일 때 오버레이를 표시한다
  • 커스텀 label을 표시한다

Blocks that use this component

opt-ui

AcquisitionAnalysis

Blocks

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

opt-ui

AlertManager

Blocks

Manage alerts with a DataTable and AlertBuilder.

opt-ui

AnalyticsDashboard

Blocks

Build an analytics dashboard with metric cards, line charts, and bar charts.

opt-ui

BillingPage

Blocks

Compose a billing overview from StatCard, BarChart, and DataTable.

opt-ui

BreakdownAnalysis

Blocks

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

opt-ui

ChatAssistant

Blocks

Compose an AI assistant screen with ChatSidebar, ChatMessageList, and ChatInput.

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

DataExplorer

Blocks

Explore filtered data with SearchCombobox, StatusSelect, and DataTable inside a group-spaced BlockLayout.

opt-ui

DebugWorkspace

Blocks

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

opt-ui

DeploymentCenter

Blocks

Manage deployments with branch and status selectors, quick actions, timelines, domains, and environment variables.

opt-ui

FunnelAnalysis

Blocks

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

opt-ui

InsightsDashboard

Blocks

Run anomaly detection and review insights with time filters, errors, dismissed items, and configurable detection methods.

opt-ui

ProjectDashboard

Blocks

Build a project overview with DashboardGrid, DeploymentTimeline, and EnvPanel.

opt-ui

ProjectOverview

Blocks

Summarize a project with metrics, navigation cards, charts, tables, code snippets, and dashboard management.

opt-ui

ProjectSettings

Blocks

Manage project settings, retention policies, cleanup previews, and storage usage with forms, tables, and code snippets.

opt-ui

RealtimeDashboard

Blocks

Monitor live activity with connection status, metric cards, and an activity feed.

opt-ui

RetentionAnalysis

Blocks

Explore cohort retention in a Surface built around RetentionHeatmap.

opt-ui

SegmentManager

Blocks

Manage segments with a DataTable and SegmentBuilder.

opt-ui

SettingsPanel

Blocks

Arrange settings navigation beside a caller-provided content slot.

opt-ui

SqlWorkspace

Blocks

Compose a SQL editing screen from SqlEditor and QueryResultsTable.

opt-ui

TaskDashboard

Blocks

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

opt-ui

TestAnalytics

Blocks

Analyze test quality with summary cards and six tabs covering overview, stability, failures, flaky tests, performance, and advanced metrics.

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

Spinner

Core

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

opt-ui

Alert

Core

Show info, success, warning, or error messages with a title, body, and dismiss button.

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

Tabs

Core

Organize tab panels with Root, TabList, Tab, and TabPanel components.

PreviousVirtualListNextStarRating