转载

[iOS]任性切换自定义转场效果的XXTransition

原文

先上Demo 效果

[iOS]任性切换自定义转场效果的XXTransition

Demo展示

XXTransition 是什么鬼?

经历过几个公司,领导换了一波波,产品换了一波波,App的转场动画也是换了一波波,于是各种 AnimatedTransitioning、 InteractiveTransition代码也写了一波波。如果项目中用到多种转场效果,那代码目录可能是像这样的。

[iOS]任性切换自定义转场效果的XXTransition

每个效果都分别有对应的实现了AnimatedTransitioning和InteractiveTransition逻辑的文件。

能不能简单点?方便的管理项目中用到的转场动画,方便的添加转场效果,同时也能满足各种转场效果的切换,手势交互的切换? Yes,u can ! 这正是XXTransition能帮你做到的,请为它转身。

XXTransition 为嘛来到这世上?

方便添加自定义转场效果,将重心放在动画效果的实现上

自由管理项目中多种转场动画,转场手势的切换,(妈妈再也不用担心恶心的需求啦)

对于原使用系统转场的工程,集成后无需修改任何原代码。

提供转场动画库。我会不断添加朴实无华和牛哔闪闪的转场动画在代码中,供你直接调用。这些效果,包括我自己亲手和不是亲手写的,如有雷同,别计较啦,都是分享啦,当然如果有大牛小牛给我投稿,我会很开心哒,也会在代码中注释出处哒。

XXTransition 该怎么跑起来?

安装

Github地址:https://github.com/mh4u/XXTransition/

将XXTransition目录文件拖到工程中即可

使用

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

   //启动XXTransition自定义转场
  [XXTransition startGoodJob:GoodJobTypeAll transitionDuration:0.3];

  self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
  [self.window makeKeyAndVisible];
  RootVC *vc = [[RootVC alloc] init];
  self.window.rootViewController = [[UINavigationController alloc] initWithRootViewController:vc];
  return YES;
}

这样一句话调用就可以开始工作啦!

Nav转场

初阶

 + (void)startGoodJob:(GoodJobType)goodJobType transitionDuration:(NSTimeInterval)duration;

该方法的第一个参数是枚举值

typedef NS_OPTIONS(NSUInteger, GoodJobType) {
    GoodJobTypeNavOnly = 1 << 0,
    GoodJobTypeModalOnly = 1 << 1,
    GoodJobTypeAll = GoodJobTypeNavOnly | GoodJobTypeModalOnly
  };

可以设置只使用自定义Nav转场还是Modal转场,或者全部使用。XXTransition会在提供的转场效果中设定一个默认的Nav转场效果。如果你原先工程中使用的是系统的Nav转场效果,那恭喜你,现在不需要改其他代码就已经可以实现自定义转场了哦(使用Modal转场和Nav转场有所区别,往下看)。

如果你想换一个XXTransition提供的Nav转场,这样设置就可以啦。

//启动XXTransition自定义转场
[XXTransition startGoodJob:GoodJobTypeAll transitionDuration:0.3];
//更改全局NavTransiton效果
[XXTransition setNavTransitonKey:XXTransitionAnimationNavPage];

可是按照PM的要求,是一个全新的转场效果怎么办,得自己写啦。XXTransition可以让你专注于动画的实现,交互手势都不用care

 //添加自定义NavTransiton效果
 NSString *someNBTransitionAnimation = @“someNBTransitionAnimation";
 [XXTransition addPushAnimation:demoTransitionAnimationFragment animation:^(id transitionContext, NSTimeInterval duration) {
      //Push动画逻辑
  }];

  [XXTransition addPopAnimation:demoTransitionAnimationFragment animation:^(id transitionContext, NSTimeInterval duration) {
    //Pop动画逻辑
  }];

   //更改全局NavTransiton效果
  [XXTransition setNavTransitonKey:someNBTransitionAnimation];

进阶

一般情况下,一个App只会用一种转场效果,但有讲究有追求的话,可能需要多种转场效果配合不同交互手势在不同VC互相push,pop时进行切换,简单画个图你就明白了

[iOS]任性切换自定义转场效果的XXTransition

偶买噶

你遇到过吗,遇到了麻烦给个赞或者星,表示同病相怜,没遇到也麻烦给个星或者赞,因为我遇到了,让我感受到你的温暖。碰到这种情况,不要蓝瘦,不用香菇,看看XXTransition怎么解决。

//启动XXTransition自定义转场
[XXTransition startGoodJob:GoodJobTypeAll transitionDuration:0.3];

//更改全局NavTransiton效果
[XXTransition setNavTransitonKey:XXTransitionAnimationNavPage];

//注册特殊ViewController的NavTransiton效果和返回手势
[XXTransition registerPushViewController:[SinkVC class] forTransitonKey:XXTransitionAnimationNavSink];
[XXTransition registerPushViewController:[PageVC class] forTransitonKey:XXTransitionAnimationNavPage];
[XXTransition registerPopGestureType:XXPopGestureTypeFullScreen forViewController:[SinkVC class]];
[XXTransition registerPopGestureType:XXPopGestureTypeForbidden forViewController:[PageVC class]];

就这样,OK啦。SinkVC和PageVC分别使用响应的Nav转场效果和返回手势,而其他VC则使用全局转场效果

Modal转场

Modal切换ViewController的XXTransition使用方法和Nav有所不同,要在需要Present的使用调用UIViewController+XXTransition.h定义的方法

- (void)xx_presentViewController:(UIViewController *)viewControllerToPresent makeAnimatedTransitioning:(void (^)(XXAnimatedTransitioning *transitioning))block completion:(void (^ __nullable)(void))completion

使用如下

- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
  [tableView deselectRowAtIndexPath:indexPath animated:YES];
  if (indexPath.row == 0) {
      SinkVC *vc =[[SinkVC alloc] init];
      [self.navigationController pushViewController:vc animated:YES];
  } else {
      ModalVC *vc = [[ModalVC alloc] init];
      //XXTransition Modal转场
      [self xx_presentViewController:vc makeAnimatedTransitioning:^(XXAnimatedTransitioning * _Nonnull transitioning) {
          transitioning.duration = 0.5;
          transitioning.animationKey = XXTransitionAnimationModalSink;
      } completion:NULL];
  }
}

如果你需要自己敲一个新的转场动画,类似于Nav转场中的自定义,专注动画实现,在下面两个方法中实现动画逻辑

[XXTransition addPresentAnimation:demoTransitionAnimationModalSink animation:^(id transitionContext, NSTimeInterval duration) {
 //Present 转场逻辑
}];  

[XXTransition addDismissAnimation:demoTransitionAnimationModalSink backGestureDirection:XXBackGesturePanDown animation:^(id transitionContext, NSTimeInterval duration) {
 //Dismiss 转场逻辑
}];
XXTransition 在dismiss的转场交互中,支持下面几中选择

typedef NS_ENUM(NSInteger,XXBackGesture){
  XXBackGestureNone, //禁用手势
  XXBackGesturePanLeft,
  XXBackGesturePanRight,
  XXBackGesturePanUp,
  XXBackGesturePanDown,
};

最后

如果你在使用XXTransition过程中发现任何问题,或是有任何建议,欢迎勾搭我。

正文到此结束
Loading...