Peek Preview 是一个很实用的功能,让用户可以快速预览内容,但是只有在支持 3D Touch 的设备上才可以使用。STPopupPreview 利用 Long Press Gesture 在非 3D Touch 设备来实现了类似的功能,通过长按松手来快速预览内容,并实现了上滑显示 Preview Actions 的功能。具体效果可参考demo:https://github.com/kevin0571/STPopupPreview 或者 Instagram 的 iOS App。
STPopupPreview 是基于 STPopup 开发的,支持 CocoaPods 和 Carthage 依赖管理。
GitHub地址(含示例):https://github.com/kevin0571/STPopupPreview
效果图:
简单的使用方法:
1、绑定 preview recognizer
CollectionViewCell *cell = [collectionView dequeueReusableCellWithReuseIdentifier:NSStringFromClass([CollectionViewCell class]) forIndexPath:indexPath]; if (!cell.popupPreviewRecognizer) { cell.popupPreviewRecognizer = [[STPopupPreviewRecognizer alloc] initWithDelegate:self]; }
2、实现相应的 Delegate 方法
返回用于预览的 preview view controller
- (UIViewController *)previewViewControllerForPopupPreviewRecognizer:(STPopupPreviewRecognizer *)popupPreviewRecognizer { if (![popupPreviewRecognizer.view isKindOfClass:[CollectionViewCell class]]) { return nil; } CollectionViewCell *cell = popupPreviewRecognizer.view; PreviewViewController *previewViewController = [self.storyboard instantiateViewControllerWithIdentifier:NSStringFromClass([PreviewViewController class])]; previewViewController.data = cell.data; previewViewController.placeholderImage = cell.imageView.image; return previewViewController; }
返回用于 present preview 的 view controller,一般是 self
- (UIViewController *)presentingViewControllerForPopupPreviewRecognizer:(STPopupPreviewRecognizer *)popupPreviewRecognizer { return self; }
返回 preview actions,可以为空
- (NSArray *)previewActionsForPopupPreviewRecognizer:(STPopupPreviewRecognizer *)popupPreviewRecognizer { return @[ [STPopupPreviewAction actionWithTitle:@"Like" style:STPopupPreviewActionStyleDefault handler:^(STPopupPreviewAction *action, UIViewController *previewViewController) { // Action handler }] ]; }