LNPopupUI 使用教程

LNPopupUI 使用教程

LNPopupUI A SwiftUI library for presenting views as popups, much like the Apple Music and Podcasts apps. 项目地址: https://gitcode.com/gh_mirrors/ln/LNPopupUI

1. 项目介绍

LNPopupUI 是一个为 SwiftUI 设计的库，用于以弹窗的形式展示视图，类似于 Apple Music 和 Podcasts 应用的弹窗效果。它是 LNPopupController 框架的 SwiftUI 封装，能够以原生的方式在 SwiftUI 中展示。

该库通过扩展 SwiftUI 的 View 类型，提供了新的功能，允许开发者以简洁的方式展示和定制弹窗内容，包括弹窗栏的标题、图片和工具栏按钮等。

2. 项目快速启动

要使用 LNPopupUI，您需要将其添加到您的项目中。以下是通过 Swift 包管理器（SPM）添加 LNPopupUI 的步骤：

首先，在 Xcode 中点击 File -> Swift Packages -> Add Package Dependency，输入 https://github.com/LeoNatan/LNPopupUI。选择您希望使用的版本。

或者，您也可以手动将包添加到您的 Package.swift 文件中：

.package(url: "https://github.com/LeoNatan/LNPopupUI.git", from: "1.5.0"),

并在您的目标中添加依赖：

.target(
    name: "BestExampleApp",
    dependencies: ["LNPopupUI"]
),

接下来，在您的项目中导入 LNPopupUI 模块：

import LNPopupUI

然后，您可以使用 .popup(isBarPresented:isPopupOpen:content:) 修饰符来展示弹窗栏和弹窗内容：

TabView {
    // 容器内容
    AlbumViews()
}.popup(
    isBarPresented: $isPopupBarPresented,
    isPopupOpen: $isPopupOpen
) {
    // 弹窗内容，弹窗打开时可见
    PlayerView(song: currentSong)
    .popupTitle(currentSong.title)
    .popupSubtitle(currentSong.subtitle)
    .popupImage(Image(currentSong.imageName))
    .popupBarItems {
        ToolbarItemGroup(placement: .popupBar) {
            Button {
                isPlaying.toggle()
            } label: {
                Image(systemName: "play.fill")
            }
            Button {
                nextSong()
            } label: {
                Image(systemName: "forward.fill")
            }
        }
    }
}

3. 应用案例和最佳实践

在您的应用中，推荐将弹窗栏展示在顶层视图上，例如 TabView 或 NavigationStack。如果您有一个包含在导航栈中，并且该导航栈又包含在 TabView 中的视图，建议在 TabView 上展示弹窗栏。

以下是展示弹窗栏的一个示例：

// 在 TabView 上使用 popup 修饰符
TabView {
    // ... 其他视图 ...
    Text("这是 TabView 中的一个视图")
        .popup(isBarPresented: $isPopupBarPresented, isPopupOpen: $isPopupOpen) {
            // 弹窗内容
        }
}

在定制弹窗栏样式时，LNPopupUI 提供了多种样式选择，包括 "floating"、"prominent" 和 "compact"，分别对应 Apple Music 应用中不同年份引入的样式。

4. 典型生态项目

目前，LNPopupUI 作为一个独立的库，没有特定的生态项目列表。但是，任何需要以弹窗形式展示信息的 SwiftUI 应用都可以考虑集成 LNPopupUI，以提供更加流畅和一致的用户体验。开发者可以根据自己的需求，对 LNPopupUI 进行扩展和定制，以适应不同的应用场景。

LNPopupUI A SwiftUI library for presenting views as popups, much like the Apple Music and Podcasts apps. 项目地址: https://gitcode.com/gh_mirrors/ln/LNPopupUI