Popup

사용자의 즉각적인 주의와 응답이 필요한 상황에서 사용하는 모달 요소입니다. 사용자의 현재 작업을 중단 시키고 팝업 내용에 집중하도록 하며, 필수적인 결정이나 확인이 필요한 경우에 사용합니다.

@MainActor struct Popup

Overview

배경을 어둡게 처리하고 화면 중앙에 콘텐츠를 표시하는 형태의 모달입니다. 내비게이션 바와 액션 영역을 설정할 수 있습니다.

대개는 SwiftUI/View/popup(isPresented:resize:contentVerticalPadding:contentHorizontalPadding:navigation:actionArea:_:) 수정자를 씁니다. 딤 처리와 표시 애니메이션까지 함께 해 줍니다. SwiftUI 표준 모달 옵션을 함께 얹어야 할 때만 이 타입을 직접 만들어 .fullScreenCover 안에 넣습니다.

@State private var showPopup = false

YourView()
    .popup(
        isPresented: $showPopup,
        navigation: {
            ModalNavigation()
                .title("알림")
        },
        actionArea: {
            ActionArea(variant: .strong(main: .init(text: "확인", action: confirm)))
        },
        {
            Text("중요한 메시지입니다.")
        }
    )

Topics

Initializers

init<V>(() -> V)

팝업 모달을 초기화합니다.

  • Parameters

    ParameterDescription
    content모달 내에 표시할 콘텐츠를 반환하는 클로저

Instance Properties

var body: some View

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

Instance Methods

func contentPadding(vertical: ModalContentPadding.Vertical, horizontal: ModalContentPadding.Horizontal) -> Popup

콘텐츠 영역의 여백을 설정합니다.

  • Parameters

    ParameterDescription
    vertical상하 여백의 적용 범위, 생략하면 기본값으로 .none 적용
    horizontal좌우 여백의 적용 여부, 생략하면 기본값으로 .default 적용

  • Return Value

    수정된 팝업 모달 뷰

  • Discussion

    좌우 28, 상하 24를 각각 켜고 끕니다. 기본값은 좌우만 적용하는 구성입니다.

func ignoresEdgeInsets(Bool) -> Popup

컨텐츠의 기본 여백을 무시할지 설정합니다.

Deprecated

contentPadding(vertical:horizontal:)을 쓰세요. ignoresEdgeInsets(true)는 contentPadding(vertical: .none, horizontal: .none)과 같습니다.

  • Parameters

    ParameterDescription
    ignoresEdgeInsets여백 무시 여부

  • Return Value

    수정된 팝업 모달 뷰

func modalActionArea((() -> ActionArea)?) -> Popup

팝업 모달 하단에 액션 영역을 설정합니다.

  • Parameters

    ParameterDescription
    actionArea하단에 배치할 ActionArea를 만드는 클로저

  • Return Value

    수정된 팝업 모달 뷰

func modalNavigation((() -> Montage.ModalNavigation)?) -> Popup

팝업 모달 상단에 내비게이션 바를 설정합니다.

  • Parameters

    ParameterDescription
    navigation내비게이션 바를 반환하는 클로저

  • Return Value

    수정된 팝업 모달 뷰

func resize(Resize) -> Popup

팝업 모달의 크기를 설정합니다.

  • Parameters

    ParameterDescription
    resize팝업 모달의 크기 설정

  • Return Value

    수정된 팝업 모달 뷰

Enumerations

enum Resize

팝업의 크기를 정의하는 열거형입니다.

Enumeration Cases

case fixed(CGFloat)

지정한 높이로 고정됩니다.

  • Parameters

    ParameterDescription
    height높이
case hug

컨텐츠 크기에 맞게 자동 조절됩니다.

Associated Extensions

extension View
func popup<V>(isPresented: Binding<Bool>, resize: Popup.Resize, contentVerticalPadding: ModalContentPadding.Vertical, contentHorizontalPadding: ModalContentPadding.Horizontal, navigation: (() -> ModalNavigation)?, actionArea: (() -> ActionArea)?, () -> V) -> some View

팝업 모달을 표시합니다.

  • Parameters

    ParameterDescription
    isPresented모달 표시 여부를 제어하는 바인딩
    resize모달 크기 조절 방식, 생략하면 기본값으로 .hug 적용
    contentVerticalPadding콘텐츠 상하 여백의 적용 범위, 생략하면 기본값으로 .none 적용
    contentHorizontalPadding콘텐츠 좌우 여백의 적용 여부, 생략하면 기본값으로 .default 적용
    navigation모달 상단에 표시할 네비게이션 클로저, 생략하면 기본값으로 nil 적용
    actionArea모달 하단에 배치할 ActionArea를 만드는 클로저, 생략하면 기본값으로 nil 적용
    content모달에 표시할 콘텐츠 클로저

  • Return Value

    팝업 모달이 적용된 뷰

  • Discussion

    화면 중앙에 표시되는 팝업 형태의 모달을 표시합니다.

func popup<V>(isPresented: Binding<Bool>, resize: Popup.Resize, ignoresEdgeInsets: Bool, navigation: (() -> ModalNavigation)?, actionArea: (() -> ActionArea)?, () -> V) -> some View

팝업 모달을 표시합니다.

Deprecated

contentHorizontalPadding을 쓰세요. ignoresEdgeInsets: true는 contentHorizontalPadding: .none과 같습니다.

  • Parameters

    ParameterDescription
    isPresented모달 표시 여부를 제어하는 바인딩
    resize모달 크기 조절 방식, 생략하면 기본값으로 .hug 적용
    ignoresEdgeInsets모달 내용이 Edge 인셋을 무시할지 여부
    navigation모달 상단에 표시할 네비게이션 클로저, 생략하면 기본값으로 nil 적용
    actionArea모달 하단에 배치할 ActionArea를 만드는 클로저, 생략하면 기본값으로 nil 적용
    content모달에 표시할 콘텐츠 클로저

  • Return Value

    팝업 모달이 적용된 뷰

Relationships

Conforms To

Swift.Sendable

SwiftUICore.View

© 2026 Wanted Lab, Inc.