zhahao / hgtransitionanimator

简单易用的控制器之间的转场动画。

HGTransitionAnimator

CocoaPods安装

1. 在 Podfile 中添加 pod 'HGTransitionAnimator'。如果安装失败,请更新本地pod库pod repo update。
2. 执行 pod install 或 pod update。
3. 导入UIViewController+HGAnimator.h

如何使用

导入头文件

#import "UIViewController+HGAnimator.h"

Present方法

// 使用封装的样式只需要调用这一句
OneViewController *oneVC=[[OneViewController alloc]init];
	[self hg_presentViewController:oneVC animateStyle:HGTransitionAnimatorFromLeftStyle  delegate:self presentFrame:_presentFrame backgroundColor:_backgroundColor animated:YES];	

Dismiss方法

// 必须掉用下面的dismiss,不要调用[self dismissViewControllerAnimated:YES completion:nil];
	[self hg_dismissViewControllerAnimated:YES completion:nil];

自定义需要做的:

实现HGTransitionAnimatorDelegate代理方法Transition
@interface ViewController ()	<HGTransitionAnimatorDelegate>
- (void)transitionAnimator:(HGTransitionAnimator *)animator animateTransitionToView:(UIView *)toView duration:(NSTimeInterval)duration{	// 弹出动画代码写在这里
}
- (void)transitionAnimator:(HGTransitionAnimator *)animator animateTransitionFromView:(UIView *)fromView duration:(NSTimeInterval)duration
{
	// 消失动画代码写在这里
}
- (NSTimeInterval)transitionDuration:(HGTransitionAnimator *)animator
{
    // 动画时间写在这里
}
- (BOOL)transitionAnimatorCanResponse:(HGTransitionAnimator *)animator
{
	// 蒙版点击是否有效
}
- (NSTimeInterval)transitionDuration:(HGTransitionAnimator *)animator
{
	//修改动画时间
}
// 更多代理方法详见demo

项目演示

查看并运行 HGTransitionAnimator/demo ,目前封装了11种基本样式.带手势识别dismiss的有3种,具体查看demo。

• 左边弹出,类似于优步、滴滴的效果,带手势拖拽识别。

	animateStyle:HGTransitionAnimatorFromLeftStyle

• 中心点消失

	animateStyle:HGTransitionAnimatorCenterStyle

• 右边弹出

	animateStyle:HGTransitionAnimatorFromRightStyle

• 显示隐藏

	animateStyle:HGTransitionAnimatorHiddenStyle

• 顶部出现

	animateStyle:HGTransitionAnimatorFromTopStyle

• 底部出现

	animateStyle:HGTransitionAnimatorFromBottomStyle

• 垂直压缩

	animateStyle:HGTransitionAnimatorVerticalScaleStyle

系统要求

该项目最低支持 iOS 8.0 和 Xcode 7.0。

注意

支持横竖屏的切换。使用控制器管理弹出视图的好处:面向协议编程,使控制器与View之间的传递控制链转换成控制器与控制器之间的传递,降低了代码的耦合度并且提高了代码的复用率,这也是Apple推出转场控制器的用意。如QQ右上角的添加、分享界面的底部弹出、都可以用自带样式定义一个专属控制器,支持。目前有11种自带的样式,基本上可以满足日常的开发需求。如果自定义,请实现HGTransitionAnimatorDelegate代理方法。如果发现bug,请issue我,如果想改进,请pull request我!

许可证

HGTransitionAnimator 使用 MIT 许可证，详情见 LICENSE 文件。