VCTransitionsLibrary –自定义iOS交互式转场动画的库

简介

VCTransitionsLibrary
提供了不可胜数适用于入栈,出栈,模态等情景下控制器切换时的转场动画.它本身提供了一个概念好的转场动画库,你可以拖到自己工程中直接利用;也提供了不少负有差距转场动画效果”互动控制器”,你可以一贯运用那个控制器来和自定义动画效果格外使用;而不是和谐支配去控制交互.

类型主页: VCTransitionsLibrary

新式示例: 点击下载

在意: 自定义视图控制器的转场动画为iOS7 +
因此 UIViewControllerTransitioningDelegate磋商, UINavigationControllerDelegate商谈和 UITabBarControllerDelegate
协议提供的系统级其他帮忙.那几个库的含义在于定义了常用的卡通效果,并封装了常用的交互操作,简化了iOS交互式转场动画的编码量!

高效入门

运作条件

  • iOS 7+
  • ARC

安装

使用 CocoaPods 安装

pod "VCTransitionsLibrary"

手动安装

把文件 AnimationControllers 和 InteractionControllers 文件夹下所有代码复制到工程中即可.

使用

在自定义转场动画时,有两类首要的类:

  • 卡通控制器 –
     这么些类是用来落到实处自定义动画的.但你表明想要使用自定义动画时,你应该提供一个卡通控制器.那个类会已毕必要的卡通片,完毕时会布告框架.
  • 互动控制器 –
    这几个类是用来管理彼此的-那个日常由某个手势空控制的竞相,允许用户通过滑行,轻扫或实施其余操作来促成七个视图控制器的导航.必须提出的是,交互控制器允许导航撤消,例如,一个用户可以在正在导航至某一页面时,突然更改主意,然后撤销了操作.

只顾: 动画和交互是截然独立的,那代表你可以在其余任何自定义控制器上独立行使交互控制器-很酷!

选用动画片控制器

AnimationControllers 文件夹中提供了无数足以整合进你的工程中的动画控制器:

自定义模态控制器显示/隐藏的卡通

2018正版葡京赌侠诗,UIViewControllerTransitioningDelegate
磋商被用来在模态控制器突显/隐藏时提供一个动画片控制器.当一个视图控制器被模态显示或隐蔽时,它的transitioningDelegate属性用来提供UIViewControllerTransitioningDelegate协议的帮衬.担当代理角色的类,通过 animationControllerForPresentedController:
presentingController: sourceController: 方法重回模态展现时的动画,
通过 animationControllerForDismissedController: 返回模态消失时的动画即可.

自定义顶部导航的转场动画

UINavigationController 有一个

id<UINavigationControllerDelegate> delegate
属性.只必要让它的代理通过 navigationController:
animationControllerForOperation: fromViewController: toViewController:
再次回到某个动画效果即可.

为了同时安装出栈/入栈都合适的卡通片效果(或者说,出栈/入栈时能运用相反方向的动画片),你可以参照下边代码:

- (id<UIViewControllerAnimatedTransitioning>)navigationController:
                                (UINavigationController *)navigationController
   animationControllerForOperation:(UINavigationControllerOperation)operation
                fromViewController:(UIViewController *)fromVC
                  toViewController:(UIViewController *)toVC {

    // 出栈时,要反转动画方向.
    _animationController.reverse = operation == UINavigationControllerOperationPop;

    return _animationController;
}

自定义底部标签栏导航的转场动画

UITabBarController 有一个 id<UITabBarControllerDelegate>
delegate属性,只须要让它的代理通过tabBarController:
animationControllerForTransitionFromViewController:
toViewController:重返某个动画效果即可.

为了给动画一个适合的可行性,你可以比较八个视图控制器的目录:

- (id <UIViewControllerAnimatedTransitioning>)tabBarController:(UITabBarController *)tabBarController
            animationControllerForTransitionFromViewController:(UIViewController *)fromVC
                                              toViewController:(UIViewController *)toVC {

    NSUInteger fromVCIndex = [tabBarController.viewControllers indexOfObject:fromVC];
    NSUInteger toVCIndex = [tabBarController.viewControllers indexOfObject:toVC];

    _animationController.reverse = fromVCIndex < toVCIndex;
    return _animationController;
}

采用交互控制器

相互控制器和动画控制器合作使用,可以兑现交互式的动画片转场效果,比如可以让用户通过手势来支配页面间的导航.交互控制器允许用户在一个转场动画中前行,后退,甚至退出.

相互控制器负责给视图添加手势,并承担在用户选用某个手势时举行对应地导航操作.

模态控制器消失时的相互

UIViewControllerTransitioningDelegate
商谈,也用来提供对交互式转场的襄助.下边是一个组成清扫手势和翻页动画的例子:

//实例变量,通常在你的初始化方法初始化它们
CEFlipAnimationController *_animationController;
CESwipeInteractionController *_interactionController;

- (id<UIViewControllerAnimatedTransitioning>)
      animationControllerForPresentedController:(UIViewController *)presented
                           presentingController:(UIViewController *)presenting
                               sourceController:(UIViewController *)source {

    // 允许交互控制器绑定它的手势识别器.
    [_interactionController wireToViewController:presented 
                                    forOperation:CEInteractionOperationDismiss];
       _animationController.reverse = NO;
    return _animationController;
}

- (id<UIViewControllerAnimatedTransitioning>)
     animationControllerForDismissedController:(UIViewController *)dismissed {
    _animationController.reverse = YES;
    return _animationController;
}

- (id<UIViewControllerInteractiveTransitioning>)
           interactionControllerForDismissal:
                (id<UIViewControllerAnimatedTransitioning>)animator {

    // 如果有交互控制器被触发了,就直接使用它.返回nil,是为了支持用户通过点击某个按钮直接返回;此时不会触发交互控制器.
    return _interactionController.interactionInProgress
                ? _interactionController : nil;
}

出栈时的并行

UINavigationControllerDelegate
也有法子为交互式转场提供援救.一个典型的好像于上地方代码的情势:

// 实例变量,通常在你的初始化方法中初始化它们.
CEFlipAnimationController *_animationController;
CESwipeInteractionController *_interactionController;

- (id<UIViewControllerAnimatedTransitioning>)
                 navigationController:(UINavigationController *)navigationController
      animationControllerForOperation:(UINavigationControllerOperation)operation
                   fromViewController:(UIViewController *)fromVC
                     toViewController:(UIViewController *)toVC {

    // 把交互控制器绑定到你的视图控制器上.
    [_interactionController wireToViewController:toVC
                                    forOperation:CEInteractionOperationPop];

    _animationController.reverse = operation == UINavigationControllerOperationPop;

    return _animationController;
}

- (id <UIViewControllerInteractiveTransitioning>)
                         navigationController:(UINavigationController *)navigationController 
  interactionControllerForAnimationController:(id <UIViewControllerAnimatedTransitioning>)animationController {

    //如果有交互控制器被触发了,就直接使用它.返回nil,是为了支持用户通过点击某个按钮直接返回;此时不会触发交互控制器. 
    return _interactionController.interactionInProgress
                ? _interactionController : nil;
}

用以标签栏控制器切换时的竞相

UITabBarControllerDelegate
切磋也为交互式转场提供了支撑.然则由于代理方法在首次初阶化时不被实施,所有要求任何措施来绑定交互控制器,如KVO:

@implementation TabBarViewController {
    CEFoldAnimationController *_animationController;
    CESwipeInteractionController *_swipeInteractionController;
}

- (id)initWithCoder:(NSCoder *)aDecoder {
    if (self = [super initWithCoder:aDecoder]) {
        self.delegate = self;

        // 创建交互/动画控制器.
        _swipeInteractionController = [CESwipeInteractionController new];
        _animationController = [CEFoldAnimationController new];
        _animationController.folds = 3;

        // 使用观察者模式监测被选中的选择器的变化情况.
        [self addObserver:self
               forKeyPath:@"selectedViewController"
                  options:NSKeyValueObservingOptionNew
                  context:nil];
    }
    return self;
}

- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id)object
                        change:(NSDictionary *)change
                       context:(void *)context
{
    if ([keyPath isEqualToString:@"selectedViewController"] )
    {
        // 把交互控制器绑定到视图控制器上.
        [_swipeInteractionController wireToViewController:self.selectedViewController
                                             forOperation:CEInteractionOperationTab];
    }
}



- (id <UIViewControllerAnimatedTransitioning>)tabBarController:(UITabBarController *)tabBarController
            animationControllerForTransitionFromViewController:(UIViewController *)fromVC
                                              toViewController:(UIViewController *)toVC {

    NSUInteger fromVCIndex = [tabBarController.viewControllers indexOfObject:fromVC];
    NSUInteger toVCIndex = [tabBarController.viewControllers indexOfObject:toVC];

    _animationController.reverse = fromVCIndex < toVCIndex;
    return _animationController;
}

-(id<UIViewControllerInteractiveTransitioning>)tabBarController:(UITabBarController *)tabBarController interactionControllerForAnimationController:(id<UIViewControllerAnimatedTransitioning>)animationController
{
    return _swipeInteractionController.interactionInProgress ? _swipeInteractionController : nil;
}

@end

相关文章