Chip

간결한 정보나 선택 상태를 시각적으로 표현합니다. 태그, 필터, 선택된 항목 등을 나타내며, 아이콘 및 텍스트와 함께 사용할 수 있습니다. 작고 유연한 형태로 다양한 인터랙션을 지원합니다.

@MainActor struct Chip

Overview

텍스트와 이미지를 포함하는 칩 형태의 버튼입니다. 다양한 크기와 스타일을 지원하며, 탭 이벤트를 처리할 수 있습니다.

Chip(
    variant: .solid,
    size: .medium,
    text: "액션"
)
.backgroundColor(.semantic(.primaryNormal))
.fontColor(.semantic(.staticWhite))
.leadingImage(Image(systemName: "heart"))

Topics

Initializers

init(variant: Variant, size: Size, text: String, handler: (() -> Void)?)

칩을 초기화합니다.

  • Parameters
    ParameterDescription
    variant칩의 외관 스타일, 생략하면 기본값으로 .solid 적용
    size칩의 크기, 생략하면 기본값으로 .medium 적용
    text칩에 표시할 텍스트
    handler칩 클릭 시 실행할 핸들러, 생략하면 기본값으로 nil 적용

Instance Properties

var body: some View

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

Instance Methods

func active(Bool) -> Chip

칩의 선택 상태를 설정합니다.

  • Parameters

    ParameterDescription
    active선택 상태 여부

  • Return Value

    수정된 칩 인스턴스

func activeColor(SwiftUI.Color) -> Chip

칩의 활성화 상태 색상을 설정합니다.

  • Parameters

    ParameterDescription
    color활성화 상태일 때의 색상

  • Return Value

    수정된 칩 인스턴스

func backgroundColor(SwiftUI.Color) -> Chip

칩의 배경색을 설정합니다.

  • Parameters

    ParameterDescription
    color적용할 배경색

  • Return Value

    수정된 칩 인스턴스

func disabled(Bool) -> Chip

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

  • Parameters

    ParameterDescription
    disable비활성화 여부

  • Return Value

    수정된 칩 인스턴스

func fontColor(SwiftUI.Color) -> Chip

칩의 텍스트 색상을 설정합니다.

  • Parameters

    ParameterDescription
    color적용할 텍스트 색상

  • Return Value

    수정된 칩 인스턴스

func imageColor(SwiftUI.Color) -> Chip

이미지의 색상을 설정합니다.

  • Parameters

    ParameterDescription
    color이미지에 적용할 색상

  • Return Value

    수정된 칩 인스턴스

func leadingImage(Image) -> Chip

칩의 좌측에 이미지를 추가합니다.

  • Parameters

    ParameterDescription
    image표시할 이미지

  • Return Value

    수정된 칩 인스턴스

func trailingImage(Image) -> Chip

칩의 우측에 이미지를 추가합니다.

  • Parameters

    ParameterDescription
    image표시할 이미지

  • Return Value

    수정된 칩 인스턴스

Enumerations

enum Size

칩의 크기를 정의합니다.

Enumeration Cases

case large

큰 크기

case medium

중간 크기

case small

작은 크기

case xsmall

가장 작은 크기

Initializers

init?(rawValue: String)
enum Variant

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

Enumeration Cases

case outlined

테두리만 있는 아웃라인 스타일

case solid

배경색이 채워진 스타일

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.