UIViewController（五）：创建自定义 Presen

UIKit将视图控制器的内容与内容被呈现和显示在屏幕上的方式分开。呈现的视图控制器由底层的presentation controller对象管理，该对象管理用于显示视图控制器的视图的视觉样式。presentation controller可以执行以下操作：

• 设置所呈现的视图控制器的尺寸。
• 添加自定义视图来更改所呈现内容的视觉外观。
• 为其任何自定义视图提供转场动画。
• 当应用程序的屏幕环境发生变化时，调整所呈现内容的视觉外观。

UIKit为标准呈现样式提供了presentation controller，当将视图控制器的呈现样式设置为UIModalPresentationCustom并提供合适的转场动画委托时，UIKit会改为使用我们自定义的presentation controller。

自定义呈现的过程

当呈现一个呈现样式为UIModalPresentationCustom的视图控制器时，UIKit会查看一个自定义presentation controller来管理呈现过程。随着呈现的进行，UIKit会调用presentation controller的方法，使其有机会设置任何自定义视图并将视图动画到某个位置。

presentation controller与任何animator对象一起工作来实现整体转场。animator对象将视图控制器的内容动画显示到屏幕上，而presentation controller处理所有其他事情。通常情况下，自定义presentation controller会为其自己的视图创建动画。但是我们也可以覆写presentation controller的presentedView方法，让animator对象为所有或者部分视图创建动画。

在呈现过程中，UIKit：

1. 调用转场动画委托对象的presentationControllerForPresentedViewController:presentingViewController:sourceViewController:方法来检索我们自定义的presentation controller。
2. 如果存在animator对象或者交互式animator对象的话，会向转场动画委托对象请求获取它们。
3. 调用自定义presentation controller的presentationTransitionWillBegin方法。在该方法的实现中，应该将任何自定义视图添加到视图层次结构中，并为这些视图创建动画。
4. 调用presentation controller的presentedView方法获取需要呈现的视图。presentedView方法返回的视图由animator对象为其创建动画。通常情况下，该方法返回需要呈现的视图控制器的根视图。自定义presentation controller可以根据需要来决定是否使用自定义背景视图来替换该视图。如果确实指定了不同的视图，则必须将需要呈现的视图控制器的根视图嵌入到presentation controller的视图层次结构中。
5. 执行转场动画。转场动画包括animator对象创建的主要动画以及我们配置的与主要动画一起执行的任何动画。在动画过程中，UIKit会调用presentation controller的containerViewWillLayoutSubviews和containerViewDidLayoutSubviews方法，以便我们可以根据需要调整自定义视图的布局。
6. 在转场动画结束时，调用presentation controller的presentationTransitionDidEnd:方法。

在移除过程中，UIKit：

1. 从呈现的视图控制器中获取我们自定义的presentation controller。
2. 如果存在animator对象或者交互式animator对象的话，会向转场动画委托对象请求获取它们。
3. 调用presentation controller的dismissalTransitionWillBegin方法。在该方法的实现中，应该将任何自定义视图添加到视图层次结构中，并为这些视图创建动画。
4. 调用presentation controller的presentedView方法获取已经呈现的视图。
5. 执行转场动画。转场动画包括animator对象创建的主要动画以及我们配置的与主要动画一起执行的任何动画。在动画过程中，UIKit会调用presentation controller的containerViewWillLayoutSubviews和containerViewDidLayoutSubviews方法，以便我们能够删除任何自定义约束。
6. 在转场动画结束时，调用presentation controller的dismissalTransitionDidEnd:方法。

在呈现过程中，presentation controller的frameOfPresentedViewInContainerView和presentedView方法可能会被多次调用，因此这两个方法的实现应该尽量简单。另外，在presentedView方法的实现中不应该尝试去设置视图层次结构。在调用该方法时，应该已经设置好视图层次结构。

创建自定义presentation Controller

要实现自定义呈现样式，请子类化UIPresentationController并添加代码为自定义呈现创建视图和动画。创建自定义presentation Controller时，请考虑以下问题：

• 想添加哪些视图。
• 想要屏幕上的视图执行怎样的动画效果。
• 呈现的视图控制器的尺寸应该是多少。
• 呈现的内容应该如何在水平正常和水平紧凑的屏幕环境之间进行适应。
• 呈现完成后，是否移除发起呈现的视图控制器的视图。

所有这些决定都要求覆写UIPresentationController类的不同方法。

设置呈现的视图控制器的Frame

可以修改呈现的视图控制器的frame，使其仅填充部分可用空间。默认情况下，呈现的视图控制器的尺寸能够完全填充容器视图。要更改frame，请覆写presentation Controller的frameOfPresentedViewInContainerView方法。以下代码显示了一个示例，其中呈现的视图控制器的大小被改为仅覆盖容器视图的右半部分。在这种情况下，presentation Controller使用背景调光视图来覆盖容器视图的另一半。

- (CGRect)frameOfPresentedViewInContainerView
{
    CGRect presentedViewFrame = CGRectZero;
    CGRect containerBounds = [[self containerView] bounds];

    presentedViewFrame.size = CGSizeMake(floorf(containerBounds.size.width / 2.0), containerBounds.size.height);
    
    presentedViewFrame.origin.x = containerBounds.size.width - presentedViewFrame.size.width;
    
    return presentedViewFrame;
}

管理和动画自定义视图

自定义呈现样式通常涉及向呈现的内容中添加自定义视图。使用自定义视图来实现纯粹的视觉装饰或者使用它们将实际行为添加到呈现中。例如，背景视图可能包含手势识别器来跟踪呈现内容边界之外的特定操作。

presentation Controller负责创建和管理与呈现有关的所有自定义视图。通常情况下，在presentation Controller的初始化过程中创建自定义视图。以下代码显示了创建自己的调光视图的自定义视图控制器的初始化方法，此方法创建视图并执行一些最小配置。

- (instancetype)initWithPresentedViewController:(UIViewController *)presentedViewController presentingViewController:(UIViewController *)presentingViewController
{
    self = [super initWithPresentedViewController:presentedViewController presentingViewController:presentingViewController];
    
    if(self)
    {
        // Create the dimming view and set its initial appearance.
        self.dimmingView = [[UIView alloc] init];
        
        [self.dimmingView setBackgroundColor:[UIColor colorWithWhite:0.0 alpha 0.4]];
        
        [self.dimmingView setAlpha:0.0];
    }
    return self;
}

使用presentationTransitionWillBegin方法将自定义视图动画显示到屏幕上。在此方法的实现中，配置自定义视图并将其添加到容器视图中，如下代码所示。使用发起呈现或者呈现的视图控制器的转场动画协调器来创建任何动画。切勿在此方法中修改呈现的视图控制器的视图。animator对象负责将呈现的视图控制器动画显示到frameOfPresentedViewInContainerView方法返回的frame去。

- (void)presentationTransitionWillBegin
{
    // Get critical information about the presentation.
    UIView* containerView = [self containerView];
    
    UIViewController* presentedViewController = [self presentedViewController];

    // Set the dimming view to the size of the container's
    // bounds, and make it transparent initially.
    [[self dimmingView] setFrame:[containerView bounds]];
    [[self dimmingView] setAlpha:0.0];

    // Insert the dimming view below everything else.
    [containerView insertSubview:[self dimmingView] atIndex:0];

    // Set up the animations for fading in the dimming view.
    if([presentedViewController transitionCoordinator])
    {
        [[presentedViewController transitionCoordinator] animateAlongsideTransition:^(id<UIViewControllerTransitionCoordinatorContext>context){
            // Fade in the dimming view.
            [[self dimmingView] setAlpha:1.0];
        } completion:nil];
    }else
    {
        [[self dimmingView] setAlpha:1.0];
    }
}

在呈现结束时，使用presentationTransitionDidEnd:方法来处理由于取消呈现所导致的任何清理。如果不满足阀值条件，交互式animator对象可能会取消转场动画。发生这种情况时，UIKit会调用presentationTransitionDidEnd:方法并传递NO值给该方法。当发生取消转场动画操作时，删除在呈现开始时添加的任何自定义视图，并将其他视图还原为之前的配置，如下所示。

- (void)presentationTransitionDidEnd:(BOOL)completed
{
    // If the presentation was canceled, remove the dimming view.
    if (!completed)
        [self.dimmingView removeFromSuperview];
}

当视图控制器被移除时，使用dismissalTransitionDidEnd:方法从视图层次结构中删除自定义视图。如果想要视图动画消失，请在dismissalTransitionDidEnd:方法中配置这些动画。以下代码显示了在前面的例子中移除调光视图的两种方法的实现。始终检查dismissalTransitionDidEnd:方法的参数以确定移除是成功还是被取消。

- (void)dismissalTransitionWillBegin
{
    // Fade the dimming view back out.
    if([[self presentedViewController] transitionCoordinator])
    {
        [[[self presentedViewController] transitionCoordinator] animateAlongsideTransition:^(id<UIViewControllerTransitionCoordinatorContext>context) {
            [[self dimmingView] setAlpha:0.0];
        } completion:nil];
    }else
    {
        [[self dimmingView] setAlpha:0.0];
    }
}

- (void)dismissalTransitionDidEnd:(BOOL)completed
{
    // If the dismissal was successful, remove the dimming view.
    if (completed)
        [self.dimmingView removeFromSuperview];
}

传递presentation Controller给UIKit

呈现一个视图控制器时，请执行以下操作来使用自定义presentation Controller显示视图控制器：

• 将需要呈现的视图控制器的UIModalPresentationCustom属性设置为UIModalPresentationCustom。
• 给需要呈现的视图控制器的transitioningDelegate属性分配一个转场动画委托对象。
• 实现转场动画委托对象的presentationControllerForPresentedViewController:presentingViewController:sourceViewController:方法。

当UIKit需要使用自定义presentation Controller时，会调用转场动画委托对象的presentationControllerForPresentedViewController:presentingViewController:sourceViewController:方法。该方法的实现应该以下代码那样简单，只需要创建自定义的presentation Controller，进行配置并返回。如果此方法返回nil，则UIKit会使用全屏呈现样式来呈现视图控制器。

- (UIPresentationController *)presentationControllerForPresentedViewController:
(UIViewController *)presented presentingViewController:(UIViewController *)presenting sourceViewController:(UIViewController *)source
{
    MyPresentationController* myPresentation = [[MyPresentationController] initWithPresentedViewController:presented presentingViewController:presenting];

    return myPresentation;
}

适应不同的屏幕环境

在屏幕上呈现内容时，UIKit会在底层特征发生改变或者容器视图的尺寸发生变化时通知我们自定义的presentation Controller。这种变化通常发生在设备旋转过程中，但也可能发生在其他时间。可以使用trait和size通知来适当调整presentation Controller的自定义视图并更新为合适的呈现样式。

有关如何适应新的trait和size的信息，请参看Building an Adaptive Interface。

Demo

Demo地址：https://github.com/zhangshijian/UIViewControllerDemo