Content badge

아이콘과 텍스트를 조합하여 특정 정보의 상태나 속성을 시각적으로 강조하기 위한 요소입니다. 카드나 리스트 등에서 사용자가 관련 정보를 빠르게 알아볼 수 있도록 돕는 라벨 역할을 합니다.

@MainActor struct ContentBadge

Overview

다양한 크기와 스타일, 색상을 제공하며 텍스트 앞뒤로 아이콘을 추가할 수 있습니다. 솔리드와 아웃라인 스타일을 지원합니다.

// 기본 솔리드 뱃지
ContentBadge(text: "New")

// 아웃라인 스타일 뱃지
ContentBadge(variant: .outlined, text: "Updated")
    .size(.medium)
    .colorStyle(.accent(SwiftUI.Color.blue))
    .leadingIcon(.check)

Topics

Initializers

init(variant: Variant, text: String)

ContentBadge를 초기화합니다.

  • Parameters
    ParameterDescription
    variant뱃지의 스타일, 생략하면 기본값으로 .solid 적용
    text뱃지에 표시할 텍스트

Instance Properties

var body: some View

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

Instance Methods

func colorStyle(ColorStyle) -> ContentBadge

뱃지의 색상 스타일을 설정합니다.

  • Parameters

    ParameterDescription
    colorStyle색상 스타일

  • Return Value

    변경된 색상 스타일이 적용된 ContentBadge

func leadingIcon(Icon, usesTemplate: Bool) -> ContentBadge

뱃지 텍스트 앞에 표시될 아이콘을 설정합니다.

  • Return Value

    선행 아이콘이 추가된 ContentBadge

  • Discussion

    • Parameters
func size(Size) -> ContentBadge

뱃지의 크기를 설정합니다.

  • Parameters

    ParameterDescription
    size뱃지 크기

  • Return Value

    변경된 크기가 적용된 ContentBadge

func trailingIcon(Icon, usesTemplate: Bool) -> ContentBadge

뱃지 텍스트 뒤에 표시될 아이콘을 설정합니다.

  • Parameters

    ParameterDescription
    trailingIcon후행 아이콘
    usesTemplate아이콘 색상에 template 렌더링 적용 여부, 생략하면 기본값으로 true 적용

  • Return Value

    후행 아이콘이 추가된 ContentBadge

Enumerations

enum ColorStyle

뱃지의 색상을 결정하는 열거형입니다.

Enumeration Cases

case accent(SwiftUI.Color, background: SwiftUI.Color?)

강조 색상 뱃지

  • Parameters
    ParameterDescription
    contentColor콘텐츠 색상
    background배경 색상, 생략하면 기본값으로 nil 적용 (contentColor의 투명도를 조절하여 사용)
case neutral(SwiftUI.Color?)

중립 색상 뱃지

  • Parameters
    ParameterDescription
    contentColor콘텐츠 색상, 생략하면 기본값으로 nil 적용 (기본 색상 사용)
enum Size

뱃지의 사이즈를 결정하는 열거형입니다.

Enumeration Cases

case medium
  • Discussion
    • medium: 큰 크기의 뱃지
case small
  • Discussion
    • small: 중간 크기의 뱃지
case xsmall
  • Discussion
    • xsmall: 가장 작은 크기의 뱃지
enum Variant

뱃지의 외관을 결정하는 열거형 타입입니다.

Enumeration Cases

case outlined

테두리만 있는 뱃지

case solid

색상이 채워진 배경을 가진 뱃지

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.