
Demo 效果展示
換過幾家公司,產品經理換了一波又一波,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;
}
一句話,搞定。
+ (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];
一般 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 的用法和 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,
};
使用中遇到任何問題或有改進建議,歡迎到倉庫反饋。