SimpleToast 使用教程

项目介绍

SimpleToast 是一个简单、轻量级、灵活且易于使用的库，用于在 iOS 或 macOS 应用程序中显示 Toast 或弹出通知，基于 SwiftUI。由于其灵活性，您可以显示任何内容，甚至可以使用该库显示简单的模态框。您决定内容，库负责其余部分。

⚠️ 注意：当前版本仍在开发中，版本更新中可能会有破坏性变化，直到版本 1.0。

项目快速启动

安装

首先，将 SimpleToast 添加到您的项目中。您可以通过 Swift Package Manager 进行安装：

dependencies: [
    .package(url: "https://github.com/sanzaru/SimpleToast.git", from: "0.1.0")
]

基本使用

以下是一个简单的示例，展示如何在 SwiftUI 视图中显示一个 Toast 通知：

import SwiftUI
import SimpleToast

struct ContentView: View {
    @State private var showToast = false
    
    private let toastOptions = SimpleToastOptions(
        hideAfter: 5
    )
    
    var body: some View {
        VStack {
            Button("显示 Toast") {
                showToast.toggle()
            }
        }
        .simpleToast(isShowing: $showToast, options: toastOptions) {
            HStack {
                Image(systemName: "exclamationmark.triangle")
                Text("这是一个简单的 Toast 消息")
            }
            .padding()
            .background(Color.red.opacity(0.8))
            .foregroundColor(Color.white)
            .cornerRadius(10)
        }
    }
}

应用案例和最佳实践

自定义内容

您可以显示任何自定义内容在 Toast 中，例如：

.simpleToast(isShowing: $showToast, options: toastOptions) {
    VStack {
        Text("自定义标题")
        Image(systemName: "star")
    }
    .padding()
    .background(Color.blue.opacity(0.8))
    .foregroundColor(Color.white)
    .cornerRadius(10)
}

自定义位置

您可以通过设置 SimpleToastOptions 中的 alignment 属性来调整 Toast 的位置：

private let toastOptions = SimpleToastOptions(
    hideAfter: 5,
    alignment: .top
)

典型生态项目

SimpleToast 可以与其他 SwiftUI 库和工具结合使用，例如：

• SwiftUIX: 扩展 SwiftUI 的功能，提供更多的控件和视图。
• CombineCocoa: 使用 Combine 框架与 UIKit 进行交互。
• Alamofire: 网络请求库，用于处理后端数据交互。

通过结合这些库，您可以构建一个功能丰富且高效的 iOS 或 macOS 应用程序。