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 }] ]; }