Progress tracker

여러 단계로 구성된 프로세스에서 사용자의 현재 위치와 전체 진행 상황을 시각적으로 표현하는 요소입니다. 단계별 작업의 순서와 관계를 명확히 보여주어 사용자가 전체 프로세스를 예측할 수 있도록 돕습니다.

@MainActor struct ProgressTracker

Overview

여러 단계로 구성된 프로세스의 현재 위치를 시각화하며, 완료 단계에는 체크 마크, 진행 중/대기 단계에는 상태에 따른 스타일을 적용합니다. 수평(horizontal)과 수직(vertical) 레이아웃을 모두 지원합니다.

  • 수평(horizontal)

  • 수직(vertical)

Topics

Structures

struct VerticalStepContent

수직 진행 추적기에서 각 단계에 표시되는 콘텐츠를 표현하는 공개 타입입니다.

Initializers

init(label: String, labelAccessoryView: (() -> any View)?, contentView: (() -> any View)?)

Instance Properties

var body: some View

Initializers

init(progress: Binding<Int>, variant: Variant)

진행 상태를 표시하는 컴포넌트를 생성합니다.

  • Parameters
    ParameterDescription
    progress진행 상태를 나타내는 바인딩 값 (1부터 시작하는 인덱스)
    variant레이아웃 및 구성을 정의하는 옵션

Instance Properties

var body: some View

뷰의 내용과 동작을 정의합니다.

Enumerations

enum Variant

레이아웃 및 구성을 정의하는 옵션입니다.

Enumeration Cases

case horizontal(labels: [String])

수평 레이아웃. 각 단계의 라벨을 지정합니다.

  • Parameters
    ParameterDescription
    labels각 단계의 라벨 텍스트 배열
case vertical(stepContents: [VerticalStepContent])

수직 레이아웃. 각 단계의 라벨과 보조/콘텐츠 뷰를 지정합니다.

  • Parameters
    ParameterDescription
    stepContents각 단계에 표시되는 콘텐츠 배열

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.