您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

[iOS] 自定義轉場效果隨心切換:XXTransition 使用指南

編輯:iOS 開發基礎

Demo 效果展示

XXTransition 是個什麼東西

換過幾家公司,產品經理換了一波又一波,App 的轉場動畫也跟著換了一波又一波,於是手裡的 AnimatedTransitioning、InteractiveTransition 代碼越堆越多。如果項目裡同時存在多種轉場效果,文件目錄大概長這樣:

每種效果各自實現一套 AnimatedTransitioning 與 InteractiveTransition 邏輯

能不能簡單點?能不能方便地管理項目中所有轉場動畫、方便地新增效果,同時還支持不同效果之間的切換和手勢交互切換?可以,這正是 XXTransition 想解決的問題。

它為什麼存在

  • 讓新增自定義轉場變得簡單,開發者只需專注於動畫本身;

  • 自由管理項目中的多種轉場動畫與返回手勢,按 ViewController 粒度切換;

  • 已有使用系統轉場的工程接入後,無需改動任何原有代碼;

  • 內附一個轉場動畫庫,可以直接調用,也歡迎投稿。

安裝

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;

第一個參數是枚舉,可以選擇只啟用 Nav 轉場、只啟用 Modal 轉場,或者全部啟用:

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

XXTransition 會在內附效果中指定一個默認的 Nav 轉場。如果你原工程用的是系統轉場,接入後不用改任何代碼就已經生效了。

想換成庫裡另一種效果:

[XXTransition startGoodJob:GoodJobTypeAll transitionDuration:0.3];
[XXTransition setNavTransitonKey:XXTransitionAnimationNavPage];

如果產品要的是一個從沒見過的新效果,那就自己寫。XXTransition 允許你只關注動畫邏輯,交互手勢完全不用管:

NSString *someNBTransitionAnimation = @"someNBTransitionAnimation";

[XXTransition addPushAnimation:someNBTransitionAnimation animation:^(id transitionContext, NSTimeInterval duration) {
    // Push 動畫邏輯
}];

[XXTransition addPopAnimation:someNBTransitionAnimation animation:^(id transitionContext, NSTimeInterval duration) {
    // Pop 動畫邏輯
}];

[XXTransition setNavTransitonKey:someNBTransitionAnimation];

Nav 轉場:進階用法

一般 App 只用一種轉場,但如果有追求,可能需要多個 VC 之間 push/pop 時配合不同手勢呈現不同效果,畫成圖大概像這樣:

是不是很熟悉

遇到這種需求別著急,XXTransition 提供了按 ViewController 註冊的能力:

[XXTransition startGoodJob:GoodJobTypeAll transitionDuration:0.3];
[XXTransition setNavTransitonKey:XXTransitionAnimationNavPage];

// 為特定 VC 註冊專屬轉場效果與返回手勢
[XXTransition registerPushViewController:[SinkVC class] forTransitonKey:XXTransitionAnimationNavSink];
[XXTransition registerPushViewController:[PageVC class] forTransitonKey:XXTransitionAnimationNavPage];
[XXTransition registerPopGestureType:XXPopGestureTypeFullScreen forViewController:[SinkVC class]];
[XXTransition registerPopGestureType:XXPopGestureTypeForbidden forViewController:[PageVC class]];

這樣 SinkVC 和 PageVC 走各自的效果與手勢,其餘 VC 沿用全局配置。

Modal 轉場

Modal 的用法和 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];
        [self xx_presentViewController:vc makeAnimatedTransitioning:^(XXAnimatedTransitioning *transitioning) {
            transitioning.duration = 0.5;
            transitioning.animationKey = XXTransitionAnimationModalSink;
        } completion:NULL];
    }
}

要寫自定義的 Modal 動畫,同樣只需在兩個 block 裡填邏輯:

[XXTransition addPresentAnimation:demoTransitionAnimationModalSink animation:^(id transitionContext, NSTimeInterval duration) {
    // Present 轉場邏輯
}];

[XXTransition addDismissAnimation:demoTransitionAnimationModalSink
                backGestureDirection:XXBackGesturePanDown
                            animation:^(id transitionContext, NSTimeInterval duration) {
    // Dismiss 轉場邏輯
}];

dismiss 階段支持的手勢方向:

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

使用中遇到任何問題或有改進建議,歡迎到倉庫反饋。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved