PanModal 使用教程

1、项目介绍

PanModal 是一个优雅且高度可定制的 iOS 底部弹窗 API，由 Slack 团队开发并开源。它支持任何类型的 UIViewController，提供无缝的模态转换体验，并保持 60 fps 的性能。PanModal 兼容 iOS 10+ 和 Swift 4.2 项目。

2、项目快速启动

安装

使用 CocoaPods

在 Podfile 中添加以下内容：

pod 'PanModal'

然后运行：

pod install

使用 Carthage

在 Cartfile 中添加以下内容：

github "slackhq/PanModal"

然后运行：

carthage update

使用 Swift Package Manager

在 Package.swift 中添加以下内容：

dependencies: [
    .package(url: "https://github.com/slackhq/PanModal.git", from: "1.2.6")
]

使用示例

首先，确保你的 UIViewController 遵循 PanModalPresentable 协议。

import PanModal

class MyViewController: UIViewController, PanModalPresentable {

    override func viewDidLoad() {
        super.viewDidLoad()
    }

    var panScrollable: UIScrollView? {
        return nil
    }

    var shortFormHeight: PanModalHeight {
        return .contentHeight(200)
    }

    var longFormHeight: PanModalHeight {
        return .maxHeight
    }
}

然后，在需要展示的地方调用 presentPanModal 方法：

let myViewController = MyViewController()
presentPanModal(myViewController)

3、应用案例和最佳实践

导航控制器和堆叠模态

PanModal 支持嵌套导航控制器和堆叠模态视图。以下是一个示例：

let navController = UINavigationController(rootViewController: MyViewController())
presentPanModal(navController)

动态调整高度

你可以在运行时动态调整模态视图的高度：

func viewDidLoad() {
    super.viewDidLoad()
    panModalSetNeedsLayoutUpdate()
    panModalTransition(to: .shortForm)
}

4、典型生态项目

PanModal 可以与其他流行的 iOS 库和框架结合使用，例如：

• RxSwift: 用于响应式编程，增强 PanModal 的交互体验。
• SnapKit: 用于简化自动布局代码，使界面构建更加高效。
• Kingfisher: 用于图片加载和缓存，提升模态视图中的图片展示效果。

通过结合这些生态项目，你可以构建出更加强大和灵活的 iOS 应用。