Switch

선택된 항목을 시각적으로 강조 되는 형태의 구조로 같은 콘텐츠 영역 내에서 보기 방식이나 필터를 변경할 때 사용될 수 있습니다.

Design

Web

iOS

Android

@MainActor struct Switch

Overview

스위치는 선택 상태를 표시하는 컴포넌트로, 체크박스와 유사한 기능을 제공합니다.

Switch(checked: true) { checked in
    print("스위치 선택 상태: \(checked)")
}

// 비활성화
Switch(checked: true)
    .disabled(true)

Note

비활성화는 SwiftUI 표준 disabled(_:)를 사용합니다. 상위 컨테이너에 한 번 걸면 하위 컴포넌트까지 함께 비활성 스타일로 표시됩니다.

init(checked: Bool, size: Size, onSelect: ((Bool) -> Void)?)

스위치를 생성합니다.

Parameters

Parameter Description
checked 스위치의 초기 선택 상태
size 스위치 크기. 생략하면 기본값으로 .small 적용
onSelect 선택 상태 변경 콜백. 생략하면 기본값으로 nil 적용

var body: some View

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

enum Size

스위치 크기 타입입니다.

case medium

중간 크기

case small

작은 크기

Conforms To

Swift.Sendable

SwiftUICore.View