轻松呈现 Toast 消息，并在显示的 Toast 消息之间实现各种交互行为。CxjToasts 提供了一个直观且高度可定制的解决方案，用于管理 iOS 应用程序中的 Toast 通知。

• 简介
• 特性
• Toast 使用示例视频
• 示例项目
• Swift 版本支持
• 隐私
• 安装
  • Swift Package Manager
  • CocoaPods
• 如何使用 Toast 消息
  • 初始化
  • 显示
  • 关闭
  • 观察
• Toast 配置
• 视图配置
• 内容配置
• 许可协议

• 预定义模板：适用于常见场景的即用型 Toast 设计。
• 可自定义 Toast：定制 Toast 消息，以匹配您应用程序的独特风格。
• 动态布局：无缝适应不同的屏幕配置。
• 易于集成的 API：只需最少的设置即可快速添加 Toast 通知。
• iOS 14+ 兼容性：完全支持现代和较旧的设备。
• Swift 现代并发：利用 Swift 的 async/await 来管理 Toast 消息。
• 灵活的动画：易于配置的动画选项。
• 交互协调：平滑管理 Toast 交互行为。
• 多种交互方法：支持滑动、点击或基于超时的关闭方式。
• 触觉反馈支持：通过触觉反馈增强用户体验。

要探索 CxjToasts 的完整功能，请查看此存储库中提供的示例项目。

示例项目演示了

• 各种 Toast 类型的预定义模板。
• 标题、图标、背景等自定义选项。
• 动态动画和交互策略。
• Toast 堆叠、隐藏和交互协调的实时示例。

只需克隆存储库并打开示例项目，即可查看 CxjToasts 的实际效果。

点击此处查看示例项目。

您可以在 Swift Package Index 上找到有关 CxjToasts 的 Swift 版本支持的最新信息

CxjToasts 不会收集任何数据。 提供此通知是为了帮助您完成 App 隐私详情。 此外，还包含了隐私清单，如果需要，可以将其集成到您的应用程序中。

您可以使用 Swift Package Manager 通过将描述添加到您的 Package.swift 文件来安装 CxjToasts

dependencies: [
    .package(url: "https://github.com/coxijcake/CxjToasts", from: "1.0.9")
]

pod "CxjToasts"

安装后，使用以下命令将库导入到您的项目中

import CxjToasts

管理 Toast 的主要入口点是 CxjToastsCoordinator.shared 单例。 它提供了显示和关闭 Toast 的方法，以及管理活动 Toast 的方法。

在使用 CxjToasts 之前，建议通过调用以下代码来初始化库

CxjToasts.start()

这确保 CxjToastsCoordinator 单例已初始化并开始观察键盘状态。 这对于依赖于键盘可见性或位置的 Toast 尤其重要，以确保它们正确显示。

使用 showToast 方法来显示 Toast 消息。 它返回一个 IdentifiableToast 对象，可用于进一步的交互。

• @discardableResult showToast(type: animated:) -> IdentifiableToast:

CxjToastsCoordinator.shared.showToast(type: toastType, animated: true)

let toast = CxjToastsCoordinator.shared.showToast(type: toastType, animated: true)
CxjToastsCoordinator.shared.dismissToast(toast, animated: true)

• type：要显示的 Toast 类型。 它可以是
  • templated(template: CxjToastTemplate)：使用预定义的模板来表示常见的 Toast 类型，例如成功、错误或信息。
  • custom(data: CxjToastType.CustomToastData)：提供自定义配置、视图设置和内容，以实现完全可自定义的 Toast。
• animated：指定是否应以动画形式显示 Toast。 默认为 true。

您可以关闭特定的 Toast、视图内的 Toast 或所有活动的 Toast

• dismissToast(toast: animated:):
• dismissToastsInsideView(_ sourceView: animated:):
• dismissAll(animated:):

您可以使用 CxjToastsCoordinator 中提供的观察者方法来观察 Toast 的状态。 这使您可以对特定的 Toast 事件做出反应，例如在 Toast 呈现或关闭时。

要开始观察 Toast 事件，请使用 add(observer:) 和 remove(observer:) 方法

CxjToastsCoordinator.shared.add(observer: someObserver)
CxjToastsCoordinator.shared.remove(observer: someObserver)

以下方法可供观察者实现，使您可以处理 Toast 生命周期事件

• willPresent(toast:)：在 Toast 呈现之前调用。
• didPresent(toast:)：在 Toast 呈现之后立即调用。
• willDismiss(toast:)：在 Toast 关闭之前调用。
• didDismiss(toast:)：在 Toast 关闭之后立即调用。

CxjToastType 枚举定义了要显示的 Toast 类型，并且具有以下情况

1. 模板化 Toast：使用预定义的模板来表示常见的 Toast 用例。
2. 自定义 Toast：通过提供特定的配置、视图设置和内容来创建自定义 Toast。

对于自定义 Toast，您需要创建一个 CxjToastType.CustomToastData 对象。

• config：一个 CxjToastConfiguration 对象，用于定义 Toast 行为，例如持续时间。
• viewConfig：一个 CxjToastViewConfiguration 对象，用于定义视觉属性，例如背景颜色和圆角半径。
• content：一个符合 CxjToastContentView 的自定义视图，用于定义 Toast 中显示的实际内容。

用于定义 Toast 的行为、外观和交互的核心结构。它提供了一个灵活的 API 来自定义动画、布局、关闭方法等。

定义 Toast 视图的视觉和结构属性。 此配置确保 Toast 无缝集成到您应用程序的设计和功能中。

通过使用预定义的模板或提供您自己的自定义内容视图以在 Toast 中显示，可以轻松地配置 Toast 内容，而无需手动布局。

CxjToasts 在 MIT 许可下可用。 有关更多信息，请参见 LICENCE。