Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kevin-lyn/stpopuppreview
An alternative peek preview for non 3D Touch devices. Inspired by Instagram.
https://github.com/kevin-lyn/stpopuppreview
force-touch ios ipad iphone popup ui ui-components
Last synced: about 1 month ago
JSON representation
An alternative peek preview for non 3D Touch devices. Inspired by Instagram.
- Host: GitHub
- URL: https://github.com/kevin-lyn/stpopuppreview
- Owner: kevin-lyn
- License: mit
- Created: 2016-05-22T14:34:31.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-02-18T12:40:07.000Z (almost 4 years ago)
- Last Synced: 2024-10-20T16:03:01.048Z (2 months ago)
- Topics: force-touch, ios, ipad, iphone, popup, ui, ui-components
- Language: Objective-C
- Homepage:
- Size: 67.4 KB
- Stars: 202
- Watchers: 10
- Forks: 30
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# STPopupPreview   
**STPopupPreview** uses long press gesture to enable quick preview of a page on non 3D Touch devices. Preview actions are also supported. This idea is inspired by Instagram.
It is built on top of of [STPopup](http://github.com/kevin0571/STPopup)(a library provides STPopupController, which works just like UINavigationController in popup style). Both STPopup and STPopupPreview support iOS 7+.
## Demo
## Features
* Long press to preview, release to dismiss.
* Slide up to show preview actions.
* Easy integration.
## Get Started
**CocoaPods**
```ruby
platform: ios, '7.0'
pod 'STPopupPreview'
```
**Carthage**
```ruby
github "kevin0571/STPopupPreview"
```
*Don't forget to drag both STPopupPreview.framework and STPopup.framework into linked frameworks.
## Usage
### Import header file
```objc
#import
```
### Attach popup preview recognizer to view
```objc
CollectionViewCell *cell = [collectionView dequeueReusableCellWithReuseIdentifier:NSStringFromClass([CollectionViewCell class]) forIndexPath:indexPath];
if (!cell.popupPreviewRecognizer) {
cell.popupPreviewRecognizer = [[STPopupPreviewRecognizer alloc] initWithDelegate:self];
}
```
### Implement STPopupPreviewRecognizerDelegate
Return the preview view controller. The preview view controller should have "contentSizeInPopup" set before its "viewDidLoad" called. More about this please read the document of [STPopup](http://github.com/kevin0571/STPopup).
```objc
- (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;
}
```
Return a view controller to present the preview view controller. Most of the time it will be the current view controller.
```objc
- (UIViewController *)presentingViewControllerForPopupPreviewRecognizer:(STPopupPreviewRecognizer *)popupPreviewRecognizer
{
return self;
}
```
Return the preview actions you want to show when slides up. It can be nil if you don't have any preview actions.
```objc
- (NSArray *)previewActionsForPopupPreviewRecognizer:(STPopupPreviewRecognizer *)popupPreviewRecognizer
{
return @[ [STPopupPreviewAction actionWithTitle:@"Like" style:STPopupPreviewActionStyleDefault handler:^(STPopupPreviewAction *action, UIViewController *previewViewController) {
// Action handler
}] ];
}
```
### Enable STPopupPreview only if 3D Touch is not available
```objc
BOOL isForceTouchAvailable = [self respondsToSelector:@selector(traitCollection)] &&
[self.traitCollection respondsToSelector:@selector(forceTouchCapability)] &&
self.traitCollection.forceTouchCapability == UIForceTouchCapabilityAvailable;
if (!isForceTouchAvailable) {
if (!cell.popupPreviewRecognizer) {
cell.popupPreviewRecognizer = [[STPopupPreviewRecognizer alloc] initWithDelegate:self];
}
}
```
## Issues & Contact
* If you have any question regarding the usage, please refer to the example project for more details.
* If you find any bug, please submit an **issue**.