🎪 Rideau

Rideau 是一种抽屉式 UI，类似于 Apple 应用程序所使用的 UI。（例如，地图、快捷指令）

🚀 Rideau 正处于发布候选版本！

概述

💎 支持多个吸附点（例如，最隐藏、半可见、完全可见，并且我们可以添加更多吸附点。）
💎 支持在移动时进行动画（例如，背景颜色变暗）
💎 支持处理 RideauView 内部 scrollview 的滚动
💎 支持基于 RideauView 所具有视图的固有内容大小进行调整大小
✅ 交互式动画来自 UIViewPropertyAnimator，因此它是真正的可中断动画，没有故障。（它不能来自 UIView.animate）

RideauView 允许灵活的吸附点。 “吸附点”指的是在拖动结束时，可拖动视图“吸附”到的指定偏移量。通常有 2 或 3 个吸附点。

我们常用的对象

RideauView
RideauViewController
RideauSnapPoint

RideauView 是此库中的核心对象。我们通常将自己的视图添加到 RideauView。

RideauViewController 包含一个 RideauView。它允许我们将 RideauView 作为模态对话框呈现。

RideauSnapPoint 定义内容视图停止的位置。

🔶 要求

iOS 10.0+ Xcode 10.1+ Swift 4.2+

📱 功能

多吸附点
与拖动和 UIScrollView 的滚动平滑集成。
自动跟踪 UIScrollView
手动设置 UIScrollView 进行跟踪
在吸附点之间使用 UIViewPropertyAnimator。

👨🏻‍💻 用法

内联呈现

let rideauView = RideauView(frame: .zero) { (config) in
  config.snapPoints = [.autoPointsFromBottom, .fraction(0.6), .fraction(1)]
}
  
let someView = ...

rideauView.containerView.set(bodyView: container.view, options: .strechDependsVisibleArea)

使用模态呈现方式呈现

let targetViewController: YourViewController = ...

let controller = RideauViewController(
  bodyViewController: targetViewController,
  configuration: {
    var config = RideauView.Configuration()
    config.snapPoints = [.autoPointsFromBottom, .fraction(1)]
    return config
}(),
  initialSnapPoint: .autoPointsFromBottom
)

present(controller, animated: true, completion: nil)

多个吸附点

我们可以使用 RideauSnapPoint 定义吸附点。

public enum RideauSnapPoint : Hashable {
  
  case fraction(CGFloat)
  case pointsFromTop(CGFloat)
  case pointsFromBottom(CGFloat)
  case autoPointsFromBottom
}

config.snapPoints = [.pointsFromBottom(200), .fraction(0.5), .fraction(0.8), .fraction(1)]

⚙️ 详情

RideauContainerView 有两种调整所添加内容视图大小的方式。

RideauContainerView.ResizingOption
- noResize
- resizeToVisibleArea

final class RideauContainerView : UIView {
  public func set(bodyView: UIView, resizingOption: ResizingOption)
}

🔌 组件

Rideau 提供了以下可能对我们有帮助的组件。

RideauMaskedCornerRoundedViewController

一个容器视图控制器，实现了蒙版圆角界面并具有一些选项。

更可自定义

let targetViewController: YourViewController = ...
let toDisplayViewController = RideauMaskedCornerRoundedViewController(viewController: targetViewController)

let controller = RideauViewController(
  bodyViewController: RideauMaskedCornerRoundedViewController(viewController: target),
  ...