Slider

사용자가 특정 범위 내에서 값을 선택할 수 있게 해주는 입력 요소입니다. 드래그나 클릭을 통해 연속적인 값이나 단계별 값을 직관적으로 조정할 수 있습니다.

@MainActor struct Slider

Overview

단일 또는 이중 슬라이더 노브를 사용하여 지정된 범위 내에서 값을 선택할 수 있습니다. 두 개의 노브를 사용하여 최소값과 최대값을 동시에 설정할 수 있으며, 각 노브에 레이블을 표시하고 값이 변경될 때 콜백을 받을 수 있습니다.

// 기본 슬라이더 (0.0 ~ 1.0 범위)
Slider()

// 사용자 정의 범위 및 레이블 포맷이 있는 슬라이더
Slider(
    isRangeSlider: true,
    valueRange: 0...100,
    labelFormatter: { "\(Int($0))%" },
    onChanged: { low, high in
        print("범위: \(low) ~ \(high)")
    }
)
.label()
.heading()

Topics

Initializers

init(isRangeSlider: Bool, minValue: CGFloat, maxValue: CGFloat, labelFormatter: ((CGFloat) -> String)?, onChanged: ((CGFloat, CGFloat) -> Void)?)

슬라이더를 초기화합니다.

  • Parameters
    ParameterDescription
    isRangeSlider슬라이더의 변형, 생략하면 기본값으로 false 적용 (단일 값 슬라이더)
    minValue슬라이더의 최소값, 생략하면 기본값으로 0 적용
    maxValue슬라이더의 최대값, 생략하면 기본값으로 1 적용
    labelFormatter슬라이더 노브에 표시될 레이블 형식을 지정하는 클로저, 생략하면 기본값으로 nil 적용 (소수점 한 자리)
    onChanged슬라이더 값이 변경될 때 호출되는 클로저, 생략하면 기본값으로 nil 적용
init(isRangeSlider: Bool, valueRange: ClosedRange<CGFloat>, labelFormatter: ((CGFloat) -> String)?, onChanged: ((CGFloat, CGFloat) -> Void)?)

슬라이더를 초기화합니다.

  • Parameters
    ParameterDescription
    isRangeSlider슬라이더의 변형, 생략하면 기본값으로 false 적용 (단일 값 슬라이더)
    valueRange슬라이더가 표현하는 값의 범위, 생략하면 기본값으로 0...1 적용
    labelFormatter슬라이더 노브에 표시될 레이블 형식을 지정하는 클로저, 생략하면 기본값으로 nil 적용 (소수점 한 자리)
    onChanged슬라이더 값이 변경될 때 호출되는 클로저, 생략하면 기본값으로 nil 적용

Instance Properties

var body: some View

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

Instance Methods

func disable(Bool) -> Slider

슬라이더의 활성화 상태를 설정합니다.

  • Parameters

    ParameterDescription
    disable비활성화 여부, 생략하면 기본값으로 true 적용

  • Return Value

    수정된 슬라이더 인스턴스

func heading(Bool) -> Slider

슬라이더 상단에 제목을 표시할지 여부를 설정합니다.

  • Parameters

    ParameterDescription
    heading제목 표시 여부, 생략하면 기본값으로 true 적용

  • Return Value

    수정된 슬라이더 인스턴스

func label(Bool) -> Slider

슬라이더 노브에 값 레이블을 표시할지 여부를 설정합니다.

  • Parameters

    ParameterDescription
    label레이블 표시 여부, 생략하면 기본값으로 true 적용

  • Return Value

    수정된 슬라이더 인스턴스

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.