概述

ResizableController 是用 swift 编写的自定义模型呈现样式。

深色模式	浅色模式

功能特性

可调整大小的视图控制器，具有自定义初始/最终高度。
适用于支持 iOS 11.0+ 的所有屏幕和设备。
为较低版本提供 iOS 13 自动呈现样式的向后兼容性。
100% 兼容其他呈现样式。
易于集成，只需几行代码。
流畅的过渡动画。
视图控制器大小更改时提供专用回调。
可以通过向下滑动和点击背景来关闭控制器。
兼容浅色和深色模式。

安装

此版本与 Swift 5 兼容。

CocoaPods

ResizableController 可通过 CocoaPods 获取。要安装它，只需将以下行添加到您的 Podfile

pod 'ResizableController', '~> 1.0'

Swift Package Manager

ResizableController 可通过 Swift Package Manager 获取。要安装它，请从 Url 添加软件包依赖项

https://github.com/paytmmoney/ResizableController

用法

ResizableControllerPositionHandler

要呈现的视图控制器，使用可调整大小的过渡，需要符合 ResizableControllerPositionHandler 协议。此协议在实现级别继承自 UIViewController。

public protocol ResizableControllerPositionHandler: UIViewController {
    var shouldShowSlideUpIndication: Bool { get }
    var sliderBackgroundColor: UIColor { get }

    var initialTopOffset: CGFloat { get }
    var finalTopOffset: CGFloat { get }

    func willMoveTopOffset(value: CGFloat)
    func didMoveTopOffset(value: CGFloat)
}

以上所有属性都是可选的，可以添加以实现不同的结果。

shouldShowSlideUpIndication

如果您不想包含直观的向上滑动指示器，请覆盖此属性。默认情况下，对于不可调整大小的视图控制器禁用。

sliderBackgroundColor

覆盖此属性以给向上滑动指示器不同的颜色。默认为 alpha 0.5 的 darkGrey

initialTopOffset

覆盖此属性以给出从顶部计算的初始自定义高度。

建议：将此偏移量视为我们应用于视图的 topAnchor 约束。

finalTopOffset

覆盖此属性以给出从顶部计算的自定义最终高度。Resizable controller 将其高度从 initialTopOffset 更改为 finalTopOffset。

willMoveTopOffset

覆盖此属性以在视图控制器更改大小之前向其添加行为。如果您覆盖此属性，请确保手动关闭视图控制器，因为默认行为将被覆盖。

didMoveTopOffset

类似于 willMoveTopOffset，但将在动画完成且视图控制器调整大小后触发。

示例

可调整大小的视图控制器

用于创建可调整大小的控制器。符合 ResizableControllerPositionHandler 并覆盖 initialTopOffset。

import ResizableController

class ResizablePresentedViewController: UIViewController {

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

extension ResizablePresentedViewController: ResizableControllerPositionHandler {
// This height 500 is from topAnchor
    var initialTopOffset: CGFloat {
        500
    }
}

固定高度视图控制器

用于创建固定高度控制器。符合 ResizableControllerPositionHandler 并覆盖 initialTopOffset 和 finalTopOffset。

import ResizableController

class FixedHeightPresentedViewController: UIViewController {

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

extension FixedHeightPresentedViewController: ResizableControllerPositionHandler {
// This height 500 is from topAnchor
    var initialTopOffset: CGFloat {
        500
    }
    
// Both initial and final height should be same to make it a fixed height controller
    var finalTopOffset: CGFloat {
        500
    }
}

或

不要覆盖任何属性，这将为您提供 iOS 13 的自动呈现，该呈现可用于较低的 iOS 版本。

import ResizableController

class FixedHeightPresentedViewController: UIViewController {

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

extension ResizablePresentedViewController: ResizableControllerPositionHandler {}

如何以模态方式呈现

要呈现，请调用以下重载方法

func present(_ viewControllerToPresent: ResizableControllerPositionHandler,
             animationDuration: TimeInterval = 0.3,
             completion: (() -> Void)? = nil)

示例

let viewController = UIStoryboard(name: "Main", bundle: nil).instantiateViewController(identifier: "ResizablePresentedViewController") as ResizablePresentedViewController
self.present(viewController)

作者

Arjun Baru，Paytmoney Ltd 的 iOS 工程师，paytmmoney.com
您可以通过 arjun.baru@paytmmoney.com 与我联系

合作者

Shahrukh Alam & Rahul Mathur

许可证

ResizableController 在 MIT 许可证下可用。有关更多信息，请参见 LICENSE 文件。

示例项目

这是一个实现 ResizableController 的示例项目示例项目

建议或反馈？

欢迎创建 pull request，打开 issue 或在 Twitter 上找到我们。