Icon button

텍스트 라벨 없이 아이콘만으로 특정 액션을 수행하는 버튼 요소입니다. 공간이 제한적이거나 사용자가 즉시 이해할 수 있는 표준적인 기능을 간결하게 제공할 때 사용합니다.

@MainActor struct IconButton

Overview

아이콘만 표시하는 간결한 버튼으로, 여러 변형과 스타일을 지원합니다:

  • 기본형(normal): 배경 없이 아이콘만 표시
  • 배경형(background): 반투명 배경을 가진 아이콘
  • 외곽선형(outlined): 테두리로 둘러싸인 아이콘
  • 솔리드형(solid): 배경색이 채워진 아이콘
IconButton(
    icon: .arrowLeft,
    handler: { print("뒤로 가기 버튼 탭됨") }
)

Topics

Initializers

init(variant: IconButton.Variant, icon: Icon, handler: (() -> Void)?)

아이콘 버튼을 생성합니다.

  • Parameters
    ParameterDescription
    variant버튼의 외관 스타일, 생략하면 기본값으로 .normal(size: 24) 적용
    icon표시할 아이콘
    handler버튼 탭 시 실행할 핸들러

Instance Properties

var body: some View

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

Instance Methods

func backgroundColor(SwiftUI.Color) -> IconButton

배경 색상을 설정합니다.

  • Parameters

    ParameterDescription
    color설정할 색상

  • Return Value

    수정된 IconButton 인스턴스

  • Discussion

    Note

    Outlined, soild variant에서만 사용 가능합니다.

func borderColor(SwiftUI.Color) -> IconButton

테두리 색상을 설정합니다.

  • Parameters

    ParameterDescription
    color설정할 색상

  • Return Value

    수정된 IconButton 인스턴스

  • Discussion

    Note

    Outlined 에서만 사용 가능합니다.

func disable(Bool) -> IconButton

버튼의 비활성화 여부를 설정합니다.

  • Parameters

    ParameterDescription
    value비활성화 여부, true이면 버튼이 비활성화됩니다.

  • Return Value

    수정된 IconButton 인스턴스

func iconColor(SwiftUI.Color) -> IconButton

아이콘 색상을 설정합니다.

  • Parameters

    ParameterDescription
    color설정할 색상

  • Return Value

    수정된 IconButton 인스턴스

func padding(CGFloat) -> IconButton

버튼의 패딩을 설정합니다.

  • Parameters

    ParameterDescription
    value패딩 값

  • Return Value

    수정된 IconButton 인스턴스

  • Discussion

    Note

    Outlined, soild variant에서만 사용 가능합니다.

func showPushBadge(Bool) -> IconButton

푸시 뱃지 표시 여부를 설정합니다.

  • Parameters

    ParameterDescription
    value푸시 뱃지 표시 여부

  • Return Value

    수정된 IconButton 인스턴스

  • Discussion

    Note

    Normal variant에서만 사용 가능합니다.

Enumerations

enum Size

버튼 사이즈를 결정하는 열거형입니다.

Enumeration Cases

case custom(size: Int)

사용자 지정 크기

  • Parameters
    ParameterDescription
    size아이콘 크기 (픽셀)
case medium

중간 크기

case small

작은 크기

enum Variant

버튼의 외관을 결정하는 열거형입니다.

Enumeration Cases

case background(size: Int, isAlternative: Bool)

배경형 아이콘 버튼 - 반투명 배경을 가진 아이콘

  • Parameters
    ParameterDescription
    size아이콘 크기 (픽셀)
    isAlternative대체 스타일 사용 여부, 생략하면 기본값으로 false 적용
case normal(size: Int)

기본형 아이콘 버튼 - 배경 없이 아이콘만 표시

  • Parameters
    ParameterDescription
    size아이콘 크기 (픽셀)
case outlined(size: Size)

외곽선형 아이콘 버튼 - 테두리로 둘러싸인 아이콘

  • Parameters
    ParameterDescription
    size아이콘 크기 (Size 열거형)
case solid(size: Size)

솔리드형 아이콘 버튼 - 배경색이 채워진 아이콘

  • Parameters
    ParameterDescription
    size아이콘 크기 (Size 열거형)

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.