Radio

Radio는 Label을 포함한 Radio로 여러 선택지 중 단 하나만 선택할 수 있도록 하는 요소입니다.
사용자는 동일한 그룹 내에서 오직 하나의 항목만 선택 가능하며, 선택 시 다른 항목은 자동으로 해제됩니다.

@MainActor struct Radio

Overview

  • 선택 상태 변경 시 콜백을 받을 수 있으며, 크기와 스타일을 조정할 수 있습니다.
  • 2가지 상태를 지원합니다: checked, unchecked
Radio(checked: true) { checked in
    print("라디오 버튼 선택 상태: \(checked)")
}

Radio(checked: false, size: .small) { checked in
    print("라디오 버튼 선택 상태: \(checked)")
}

Topics

Initializers

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

라디오 버튼을 생성합니다.

  • Parameters
    ParameterDescription
    checked라디오 버튼의 초기 선택 상태
    size라디오 버튼 크기. 생략하면 기본값으로 .medium 적용
    onSelect선택 상태 변경 콜백. 생략하면 기본값으로 nil 적용

Instance Properties

var body: some View

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

Instance Methods

func bold(Bool) -> Radio

레이블을 볼드체로 설정합니다.

  • Parameters

    ParameterDescription
    isBold볼드 적용 여부, 생략하면 기본값으로 true 적용

  • Return Value

    수정된 라디오 버튼 컴포넌트

  • Discussion

    Note

    이 설정은 labelTypography에서 지정한 굵기보다 우선합니다.

    Note

    레이블이 지정되지 않은 경우 이 설정은 적용되지 않습니다.

func disable(Bool) -> Radio

컨트롤을 비활성화합니다.

  • Parameters

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

  • Return Value

    수정된 라디오 버튼 컴포넌트

func label(String) -> Radio

레이블 텍스트를 설정합니다.

  • Parameters

    ParameterDescription
    text레이블에 표시할 텍스트

  • Return Value

    수정된 라디오 버튼 컴포넌트

func labelTypography(Typography.Variant?, weight: Typography.Weight?, color: SwiftUI.Color?) -> Radio

레이블의 타이포그래피 속성을 설정합니다.

  • Parameters

    ParameterDescription
    variant레이블 변형, 생략하면 기본값으로 nil 적용
    weight레이블 굵기, 생략하면 기본값으로 nil 적용
    color레이블 색상, 생략하면 기본값으로 nil 적용

  • Return Value

    수정된 라디오 버튼 컴포넌트

  • Discussion

    Note

    레이블이 지정되지 않은 경우 이 설정은 적용되지 않습니다.

func tight(Bool) -> Radio

레이블을 더 조밀한 레이아웃으로 표시합니다.

  • Parameters

    ParameterDescription
    tight조밀한 레이아웃 적용 여부, 생략하면 기본값으로 true 적용

  • Return Value

    수정된 라디오 버튼 컴포넌트

  • Discussion

    Note

    레이블이 지정되지 않은 경우 이 설정은 적용되지 않습니다.

Enumerations

enum Size

라디오 버튼 크기 타입입니다.

Enumeration Cases

case medium

중간 크기

case small

작은 크기

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.