CLHoppingViewController 版本 0.1.5

CLHoppingViewController 版本 0.1.5

测试已测试
语言语言 Obj-CObjective C
许可证 MIT
发布时间上次发布2014年12月

未声明维护。



这是一个基于块的自定义容器视图控制器,专为应用启动、登录和注册场景设计。

动机

我们经常遇到的一个问题是,如何处理应用的启动流程。标准的容器视图控制器(如UINavigationControllerUITabBarController)并没有提供一个很好的解决方案来处理与应用启动相关的相关条件流程。

以下是一个典型的应用启动流程

  1. 显示一些精美的启动画面,同时重新加载缓存状态(或可能是从网络刷新)。
  2. 如果是用户第一次登录,则显示注册/登录界面。
  3. 如果没有已保存的用户会话,则显示注册/登录UX。
  4. 转到主应用流程(通常是某个在Storyboard中的UINavigationController)。

对此的常见解决方案是在流程中涉及的各个UIViewControls内部嵌入一些条件/一次性逻辑,并使用UINavigationController根据这些条件推入/弹出所需的UX元素。另一种方法是使用模式控制器,甚至替换关键窗口的rootViewController。所有这些方法都导致了一个乱糟糟的解决方案,启动序列的实际逻辑分散在多个源文件中,难以控制过渡和令人烦恼的错误。

进入CLHoppingViewController

这个自定义容器的观点是:流程中的每个UX元素都是独立的,并与流程的其他部分解耦。它只报告使用unhop方法完成使用后,并将流程控制返回给父视图控制器。

例如,我们可以创建一个名为CLHoppingViewController的派生类,它“跳转”到启动画面。然后,当启动画面调用unhop时,它跳转到注册/登录UX(如果是第一次使用),或者如果没有保存会话,则跳转到最后一个会话等。

安装

API

跳转到另一个视图控制器

- (void)hopToViewController:(UIViewController *)newViewController then:(void(^)(void))block;

立即过渡到指定的视图控制器(交叉淡入)。当调用unhop时,将调用block。如果blocknil,则不会发生任何操作。

取消挂钩返回 then

- (void)unhop;

导致在最后的 hopToViewController:then: 中定义的 then 块被调用。

通常,这通过以这种方式访问父跳转视图控制器从子视图控制器中进行调用

#import <CLHoppingViewController.h>

- (void)readyToHopBack
{
  [self.hoppingViewController unhop];
}

自定义转化

CLHoppingViewController 通过传递给各个跳跃函数的块支持自定义转化。

- (void)hopToViewController:(UIViewController *)newViewController
                 transition:(CLHoppingViewControllerTransitionBlock)transition
                       then:(void(^)(void))block;

这将触发跳跃期间的 transition 块。转换块的签名如下

typedef void(^CLHoppingViewControllerTransitionBlock)(UIViewController *fromViewController, UIViewController *toViewController, void(^completion)(BOOL finished));
  • fromViewController:源 UIViewController
  • toViewController:目的 UIViewController
  • 完成:一个在转换完成时必须被调用的块

注意:在开始转化之前,toViewController.view 将被添加到容器(containerViewForChildViewController)的视图层次中,因此无需手动添加。

自定义容器视图

默认情况下,CLHoppingViewController 将目的视图控制器视图作为 [self view] 的子视图添加。如果您想更改此操作,请覆盖 [CLHoppingViewController containerViewForChildViewController] 并返回您希望用作子视图控制器容器的任何视图。

作者

Elad Ben-Israel,[电子邮件保护]

许可

CLHoppingViewController 在 MIT 许可下可用。有关更多信息,请参阅 LICENSE 文件。