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

WizardForm

Shell

Guide sequential input with field definitions, per-step validation, an associated progress indicator, and a review step.

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

Live preview

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

100%

다단계 폼 (Wizard)

  1. 1
    기본 정보
  2. 2
    상세 정보
  3. 3
    확인

WizardForm

PropTypeDefaultDescription
fieldsRequiredFormFieldDef[]—폼 필드 정의 배열
stepsRequiredWizardStepDef[]—단계 정의. { id, label, fields: string[] }
showReviewbooleantrue마지막 리뷰 단계 표시 여부
onSubmit(values: Record<string, unknown>) => void | Promise<void>—제출 핸들러
onStepChange(stepIndex: number) => void—단계 변경 핸들러
labelsWizardFormLabels—i18n용 라벨 오버라이드

컴포넌트 의존 관계

깊이
▼ USES (3)WizardFormformcheckboxradio-group
View test results

테스트 커버리지

2026년 7월 9일11/11 통과
11성공
0실패
11전체
  • 폼을 렌더링한다
  • 진행 표시기를 렌더링한다
  • 첫 단계 필드를 렌더링한다
  • 다음 버튼을 렌더링한다
  • 첫 단계에서 이전 버튼을 숨긴다
  • labels로 텍스트를 커스텀한다
  • showReview=false면 리뷰 단계를 생략한다
  • checkbox 필드 값을 제출한다
  • onStepChange 콜백을 호출한다
  • 필수 필드 입력 후 다음 단계로 이동한다
  • 이전 버튼으로 이전 단계로 돌아갈 수 있다

Related components

opt-ui

Form

Core

Build accessible forms with opt-ui-primitives Form APIs, field validation, specialized inputs, and shared form store hooks.

opt-ui

SettingsForm

Shells

Build settings forms from data with validation, radio buttons, and checkboxes.

opt-ui

AuthForm

Shells

Switch between sign-in and sign-up forms with email and password validation and a remember-me option.

opt-ui

DynamicFieldForm

Shells

Add and remove fields at runtime with count limits, individual validation, and dynamic store updates.

opt-ui

FileUploadForm

Shells

Select files with metadata, image previews, size limits, and description input.

opt-ui

KeyValueEditor

Shells

Edit key-value pairs with dynamic rows, secret-value visibility, and validation.

PreviousAuthFormNextDynamicFieldForm