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