微信 && 微博 图片浏览器
PhotoBrower.gif
scrollView.gif
tableView.gif
PhotoBrowser-IM.gif
PhotoBrower_Pan.gif
更新内容
- 1.图片浏览器大改版, 将之前的
UIView改成UIViewController - 2.适配
iPhoneX、iPhoneXS、iPhoneXR、iPhoneXS_Max - 3.完美适配 屏幕旋转 , 请在真机上测试 旋转功能
- 4.新增IM 聊天时 图片浏览器功能, 详情请看Demo (2019/2/2)
- 5.新增 图片预加载的功能 (2019/3/13)
- 6.新增图片 拖拽 消失 或 回显的功能
一.功能描述及要点
- 1.依赖
SDWebImage(4.0)以及FLAnimatedImage - 2.加载九宫格图片,scrollView ,tableView , IM 聊天
- 3.高仿 微信和微博 图片浏览效果,显示和回显动画
- 4.提供删除图片和下载图片等功能
- 5.其他类型Demo,会尽快增添进去
二.方法调用
1.创建KNPhotoBrowser,并传入相应的参数
// 1.每个控件都弄成一个对象, 放入一个数组中
KNPhotoItems *items = [[KNPhotoItems alloc] init];
items.url = [urlArr[i] stringByReplacingOccurrencesOfString:@"thumbnail" withString:@"bmiddle"];
items.sourceView = imageView;
[self.itemsArr addObject:items];
// 直接跳入 图片浏览器 --> 详情请看Demo
KNPhotoBrowser *photoBrowser = [[KNPhotoBrowser alloc] init];
photoBrowser.itemsArr = [self.itemsArr copy];
photoBrowser.isNeedPageControl = true;
photoBrowser.isNeedPageNumView = true;
photoBrowser.isNeedRightTopBtn = true;
photoBrowser.isNeedPrefetch = true;
photoBrowser.isNeedPictureLongPress = true;
photoBrowser.currentIndex = tap.view.tag;
[photoBrowser present];
2.提供代理方法 --> KNPhotoBrowserDelegate
/* PhotoBrowser 即将消失 */
- (void)photoBrowserWillDismiss;
/* PhotoBrowser 右上角按钮, 弹出框的点击 */
- (void)photoBrowserRightOperationActionWithIndex:(NSInteger)index;
/* PhotoBrowser 保存图片是否成功 */
- (void)photoBrowserWriteToSavedPhotosAlbumStatus:(BOOL)success;
/* PhotoBrowser 删除图片成功后返回-- > 相对 Index */
- (void)photoBrowserRightOperationDeleteImageSuccessWithRelativeIndex:(NSInteger)index;
/* PhotoBrowser 删除图片成功后返回-- > 绝对 Index */
- (void)photoBrowserRightOperationDeleteImageSuccessWithAbsoluteIndex:(NSInteger)index;
3.提供 消失方法
[_photoBrowser dismiss];
4.API
/**
current select index
*/
@property (nonatomic,assign) NSInteger currentIndex;
/**
contain KNPhotoItems : url && UIView
*/
@property (nonatomic,strong) NSArray<KNPhotoItems *> *itemsArr;
/**
contain ActionSheet alert contents ,which is belong NSString type
*/
@property (nonatomic,strong) NSArray<NSString *> *actionSheetArr;
/**
is or not need pageNumView , Default is false
*/
@property (nonatomic,assign) BOOL isNeedPageNumView;
/**
is or not need pageControl , Default is false
*/
@property (nonatomic,assign) BOOL isNeedPageControl;
/**
is or not need RightTopBtn , Default is false
*/
@property (nonatomic,assign) BOOL isNeedRightTopBtn;
/**
is or not need PictureLongPress , Default is false
*/
@property (nonatomic, assign) BOOL isNeedPictureLongPress;
/**
is or not need pan Gesture, Default is false
*/
@property (nonatomic,assign) BOOL isNeedPanGesture;
/**
PhotoBrowser show
*/
- (void)present;
/**
PhotoBrowser dismiss
*/
- (void)dismiss;
5.注意点 : 强引用会导致PhotoBrowser 在dismiss时 无法销毁
[强烈要求将以下代码写到代理方法中去]关于弹出框的内容,可在KNPhotoBrowser.m 的operationBtnIBAction 方法中增减 (注意:代码中会存在强引用,所以切记将 weakSelf写入,不然当浏览器消失的时候,会存在强引用,不走 dealloc 方法)
__weak typeof(self) weakSelf = self;
KNActionSheet *actionSheet = [[KNActionSheet alloc] initWithCancelTitle:nil otherTitleArr:self.actionSheetArr.copy actionBlock:^(NSInteger buttonIndex) {
if([weakSelf.delegate respondsToSelector:@selector(photoBrowserRightOperationActionWithIndex:)]){
[weakSelf.delegate photoBrowserRightOperationActionWithIndex:buttonIndex];
}
}];
[actionSheet show];
补充
- 1.目前适配 九宫格,scrollView,tableView, IM类型
- 2.如果bug, 希望大家给个issue,一起努力改好
- 3.完美适配
iPhoneiPad - 4.完美适配
横竖屏: 模仿微信和微博
