Skip to content

Latest commit

 

History

History
148 lines (121 loc) · 5.2 KB

README_Chinese.md

File metadata and controls

148 lines (121 loc) · 5.2 KB
Raw

image

KNPhotoBrowser

中文 | English

微信 && 微博 图片浏览器

⭐️⭐️⭐️⭐️⭐️⭐️⭐️ 有任何需要增加的功能,请直接邮箱联系我.欢迎点赞,谢谢 ⭐️⭐️⭐️⭐️⭐️⭐️⭐️ image image image image image image

更新内容

  • 1.图片浏览器大改版, 将之前的 UIView 改成 UIViewController
  • 2.适配 iPhoneX、iPhoneXS、iPhoneXR、iPhoneXS_Max
  • 3.完美适配 屏幕旋转 , 请在真机上测试 旋转功能
  • 4.新增IM 聊天时 图片浏览器功能, 详情请看Demo (2019/2/2)
  • 5.新增 图片预加载的功能 (2019/3/13)
  • 6.新增图片 拖拽 消失 或 回显的功能(2019/4/16)

一.功能描述及要点

  • 1.依赖 SDWebImage(5.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.完美适配 iPhone iPad
  • 4.完美适配 横竖屏 : 模仿微信和微博