Thumbnail

이미지나 영상 등 전체 콘텐츠를 대표하는 이미지입니다. 다양한 비율에 맞게 콘텐츠를 표시할 수 있으며, 사용자가 내용을 쉽게 식별하고 탐색할 수 있도록 돕습니다.

@MainActor struct Thumbnail

Overview

Thumbnail은 원격 URL에서 이미지를 로드하여 지정된 비율과 크기로 표시합니다. 이미지 로딩 상태에 따른 플레이스홀더를 지원하고, 둥근 모서리와 테두리 스타일을 적용할 수 있습니다.

// 기본 정사각형 썸네일
Thumbnail(urlString: imageURL, ratio: .r1x1)
   .width(100)

// 16:9 비율의 둥근 모서리 썸네일
Thumbnail(urlString: imageURL, ratio: .r16x9)
   .width(320)
   .radius(true)

// 테두리가 있는 썸네일
Thumbnail(urlString: imageURL, ratio: .r1x1)
   .width(50)
   .border(true)

Topics

Initializers

init(urlString: String, ratio: Ratio)

썸네일을 초기화합니다.

  • Parameters
    ParameterDescription
    urlString로드할 이미지의 URL 문자열
    ratio적용할 가로세로 비율

Instance Properties

var body: some View

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

Instance Methods

func border(Bool) -> Thumbnail

썸네일에 테두리를 적용합니다.

  • Parameters

    ParameterDescription
    border테두리 적용 여부, 생략하면 기본값으로 true 적용

  • Return Value

    수정된 Thumbnail 인스턴스

func radius(Bool) -> Thumbnail

썸네일에 둥근 모서리를 적용합니다.

  • Parameters

    ParameterDescription
    radius둥근 모서리 적용 여부, 생략하면 기본값으로 true 적용

  • Return Value

    수정된 Thumbnail 인스턴스

func width(CGFloat) -> Thumbnail

썸네일의 너비를 설정합니다.

  • Parameters

    ParameterDescription
    width썸네일의 너비

  • Return Value

    수정된 Thumbnail 인스턴스

Enumerations

enum Ratio

썸네일의 가로세로 비율을 정의하는 열거형입니다.

Enumeration Cases

case r10x16

10:16 비율

case r16x10

16:10 비율 (와이드스크린 모니터)

case r16x9

16:9 비율 (와이드스크린 비디오)

case r1_618x1

황금비(1.618:1)

case r1x1

1:1 비율 (정사각형)

case r1x1_618

역황금비(1:1.618)

case r1x2

1:2 비율

case r21x9

21:9 비율 (울트라와이드 영화)

case r2x1

2:1 비율

case r2x3

2:3 비율 (일부 사진)

case r3x2

3:2 비율 (일부 사진)

case r3x4

3:4 비율

case r4x3

4:3 비율 (전통적인 TV, 모니터)

case r4x5

4:5 비율 (일부 소셜 미디어 이미지)

case r5x4

5:4 비율

case r9x16

9:16 비율 (스마트폰 세로 화면)

case r9x21

9:21 비율 (세로 울트라와이드)

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.