- GitHub 地址： KNSemiModalViewController
- star:1700+
⭐️⭐️⭐️
以下内容来源于官方源码、 README 文档、测试 Demo或个人使用总结 ！
UIViewController+KNSemiModal Category
UIViewController+KNSemiModal is an effort to make a replica of semi-modal view with pushed-back stacked animation found in the beautiful Park Guides by National Geographic app. You can see this original semi-modal view below.
This library (ARC) is designed as a Category to UIViewController so you don't have to subclass and you can simply drop in any project and it will just work!
UIViewController+KNSemiModal 可以实现半模态视图的堆叠效果，使用范畴（Category）实现，代码侵入性较小。
Original screenshot
Replica (view demo video to see the beautiful animation)*
On iPad
Features
- Works with bare UIViewController
- Works with UIViewController contained inside UINavigationController
- Works with UIViewController contained inside UINavigationController, contained inside UITabbarController
- Auto handling of modal frame size
- Auto handling of touch area for dismissal
- Resizable after presenting so that keyboard related interactions are possible
- Easy to understand and very small code base, only 2 files
- Trivial to implement as subclass
- Landscape support (not during presentation)
- Only use basic CAAnimation
- iPad support (experimental)
- Minimum iOS 5.0 (if you need 4.x support, use older commits before Jan 2013)
Optional parameters
- animation duration
- parent alpha
- optional push-back
- shadow opacity
- disabling the cancel action
- transition style: slide up, fade
Easily extend this to anything you would want to make configurable. Feel free to submit pull requests.
可选参数：
// 结构，相关的配置参数
extern const struct KNSemiModalOptionKeys {
__unsafe_unretained NSString *traverseParentHierarchy; // 遍历父层次结构，BOOL类型. default is YES.
__unsafe_unretained NSString *pushParentBack; // 推回父视图，BOOL类型. default is YES.
__unsafe_unretained NSString *animationDuration; // 动画延时，double 类型, in seconds. default is 0.5.
__unsafe_unretained NSString *parentAlpha; // 父视图透明度，float 类型.值越小越暗. default is 0.5.
__unsafe_unretained NSString *parentScale; // 父视图缩放比例，double 类型 default is 0.8
__unsafe_unretained NSString *shadowOpacity; // 阴影不透明度，default is 0.8
__unsafe_unretained NSString *transitionStyle; // 动画类型，NSNumber 类型
__unsafe_unretained NSString *disableCancel; // 是否禁用取消，BOOL 类型，default is NO.
__unsafe_unretained NSString *backgroundView; // 自定义背景视图，UIView 类型
} KNSemiModalOptionKeys;
// 动画类型
NS_ENUM(NSUInteger, KNSemiModalTransitionStyle) {
KNSemiModalTransitionStyleSlideUp, // 向上滑动
KNSemiModalTransitionStyleFadeInOut, // 淡入淡出
KNSemiModalTransitionStyleFadeIn, // 淡入
KNSemiModalTransitionStyleFadeOut, // 淡出
};
// 使用时要根据指定类型封装
-(void)kn_registerDefaultsAndOptions:(NSDictionary*)options {
[self ym_registerOptions:options defaults:@{
KNSemiModalOptionKeys.traverseParentHierarchy : @(YES),
KNSemiModalOptionKeys.pushParentBack : @(YES),
KNSemiModalOptionKeys.animationDuration : @(0.5),
KNSemiModalOptionKeys.parentAlpha : @(0.5),
KNSemiModalOptionKeys.parentScale : @(0.8),
KNSemiModalOptionKeys.shadowOpacity : @(0.8),
KNSemiModalOptionKeys.transitionStyle : @(KNSemiModalTransitionStyleSlideUp),
KNSemiModalOptionKeys.disableCancel : @(NO),
}];
}
NSDictionary *options = @{
// 遍历父层次结构，BOOL类型. default is YES.
KNSemiModalOptionKeys.traverseParentHierarchy:@(YES),
// 父视图后移动画，BOOL类型. default is YES.
KNSemiModalOptionKeys.pushParentBack:@(NO),
// 动画延时，double 类型. in seconds. default is 0.5.
KNSemiModalOptionKeys.animationDuration:@(0.25),
// 父视图透明度，float 类型.值越小越暗. default is 0.5.
KNSemiModalOptionKeys.parentAlpha:@(0.5),
// 父视图缩放比例，double 类型 default is 0.8
KNSemiModalOptionKeys.parentScale:@(1),
// 阴影不透明度，default is 0.8
KNSemiModalOptionKeys.shadowOpacity:@(0.6),
// 动画类型，NSNumber 类型
KNSemiModalOptionKeys.transitionStyle: @(KNSemiModalTransitionStyleFadeInOut),
// 是否禁用取消，BOOL 类型，default is NO.
KNSemiModalOptionKeys.disableCancel:@(NO),
// 自定义背景视图，UIView 类型
KNSemiModalOptionKeys.backgroundView:[UIView new]
};
Installation / How to use
- Copy 4 files in
Sourcefolder to your project - Add
QuartzCore.frameworkto your project -
#import "UIViewController+KNSemiModal.h"in your ViewController - Call
[self presentSemiModalView:myView] - Call
[self dismissSemiModalView]either from parent/presenting or child/presented controller
使用
官方 Demo1
显示视图
- (IBAction)buttonDidTouch:(id)sender {
// 你可以呈现一个简单的 UIImageView 或任何其他的 UIView ，而且不需要关心关闭方法
UIImageView * imagev = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"temp.jpg"]];
UIImageView * bgimgv = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"background_01"]];
[self presentSemiView:imagev
withOptions:@{
KNSemiModalOptionKeys.backgroundView:bgimgv
}];
}
官方 Demo2：
显示大小可以改变的视图
部分代码：
@implementation KNSecondViewController
- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil {
self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil];
if (self) {
self.title = @"Second";
self.tabBarItem.image = [UIImage imageNamed:@"second"];
// 请注意，你需要拥有正在呈现的ViewController的所有权
semiVC = [[KNThirdViewController alloc] initWithNibName:@"KNThirdViewController" bundle:nil];
// 您可以选择收听通知
// 视图显示完成后
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(semiModalPresented:)
name:kSemiModalDidShowNotification
object:nil];
// 视图隐藏后
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(semiModalDismissed:)
name:kSemiModalDidHideNotification
object:nil];
// 视图被重新调整大小后
[[NSNotificationCenter defaultCenter] addObserver:self
selector:@selector(semiModalResized:)
name:kSemiModalWasResizedNotification
object:nil];
}
return self;
}
#pragma mark - Demo
- (IBAction)buttonDidTouch:(id)sender {
// You can also present a UIViewController with complex views in it
// and optionally containing an explicit dismiss button for semi modal
[self presentSemiViewController:semiVC withOptions:@{
KNSemiModalOptionKeys.pushParentBack : @(YES),
KNSemiModalOptionKeys.animationDuration : @(2.0),
KNSemiModalOptionKeys.shadowOpacity : @(0.3),
}];
}
#pragma mark - Optional notifications
- (void) semiModalResized:(NSNotification *) notification {
if(notification.object == self){
NSLog(@"The view controller presented was been resized");
}
}
- (void)semiModalPresented:(NSNotification *) notification {
if (notification.object == self) {
NSLog(@"This view controller just shown a view with semi modal annimation");
}
}
- (void)semiModalDismissed:(NSNotification *) notification {
if (notification.object == self) {
NSLog(@"A view controller was dismissed with semi modal annimation");
}
}
-(void)dealloc {
[[NSNotificationCenter defaultCenter] removeObserver:self];
}
被呈现视图控制器中的动作方法
// 关闭视图
- (IBAction)dismissButtonDidTouch:(id)sender {
// 调用父控件ViewController 以关闭视图
// 视图层次结构要小心
UIViewController * parent = [self.view containingViewController];
if ([parent respondsToSelector:@selector(dismissSemiModalView)]) {
[parent dismissSemiModalView];
}
}
// 重新设置大小
- (IBAction)resizeSemiModalView:(id)sender {
UIViewController * parent = [self.view containingViewController];
if ([parent respondsToSelector:@selector(resizeSemiView:)]) {
[parent resizeSemiView:CGSizeMake(320, arc4random() % 280 + 180)];
}
}
官方 Demo3：
显示 tableView 列表：
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
[tableView deselectRowAtIndexPath:indexPath animated:NO];
// You have to retain the ownership of ViewController that you are presenting
// ⚠️必须要保留被呈现视图控制器的拥有权
// ⚠️就是说被呈现的视图控制器要设置成它的属性或者实例对象
[self presentSemiViewController:modalVC
withOptions:@{
KNSemiModalOptionKeys.pushParentBack : @(NO),
KNSemiModalOptionKeys.parentAlpha : @(0.8)
}];
// 以下的代码是无效的
// KNModalTableViewController * vc = [[KNModalTableViewController alloc] initWithStyle:UITableViewStylePlain];
// [self presentSemiViewController:vc];
}
TableView 的 frame 属性在其指定初始化方法中设置：
- (id)initWithStyle:(UITableViewStyle)style {
self = [super initWithStyle:style];
if (self) {
// 设置 frame
self.view.frame = CGRectMake(0, 0, 320, 200);
}
return self;
}
以模态方式显示一张图片
实现代码：
- (IBAction)buttonDidClicked:(id)sender {
// 加载图片方式一，有缓存
UIImageView *imageView = [[UIImageView alloc] initWithImage:[UIImage imageNamed:@"boat"]];
// 加载图片方式二，无缓存
// NSString *path = [[NSBundle mainBundle] pathForResource:@"boat" ofType:@"png"];
// UIImage *fileImage = [UIImage imageWithContentsOfFile:path];
NSDictionary *options = @{
// 父视图后移动画，BOOL类型. default is YES.
KNSemiModalOptionKeys.pushParentBack: @(NO),
// 动画延时，double 类型. in seconds. default is 0.5.
KNSemiModalOptionKeys.animationDuration: @(0.25),
// 父视图透明度，float 类型.值越小越暗. default is 0.5.
KNSemiModalOptionKeys.parentAlpha: @(0.5),
// 父视图缩放比例，double 类型 default is 0.8
KNSemiModalOptionKeys.parentScale: @(1),
// 阴影不透明度，default is 0.8
KNSemiModalOptionKeys.shadowOpacity: @(0.6),
// 动画类型，NSNumber 类型
KNSemiModalOptionKeys.transitionStyle: @(KNSemiModalTransitionStyleFadeInOut),
// 是否禁用取消，BOOL 类型，default is NO.
KNSemiModalOptionKeys.disableCancel: @(NO),
};
[self presentSemiView:imageView withOptions:options completion:^{
NSLog(@"completion!");
}];
}
