PeekView alternatives and similar libraries
Based on the "Force Touch" category.
Alternatively, view PeekView alternatives based on common mentions on social networks and blogs.
-
JustPeek
DISCONTINUED. JustPeek is an iOS Library that adds support for Force Touch-like Peek and Pop interactions on devices that do not natively support this kind of interaction.
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of PeekView or a related project?
README
PeekView
When implementing peek, pop and preview actions with 3D Touch, you may want to support such features for users accessing your app from older devices that don't provide 3D Touch capibility. PeekView hence can be used as an alternative in such case.
(Please ignore the low resolution of the GIF. Try the demo for actual experience.)
Note
Things that need improving
- Better solution for Objective-C integration (the current is sort of hacky!)
- Better documenting in code
- Content view panned: Smoother animation
- Action style: Selected functionality
- More customizable UI if needed (requests are welcome)
- Bug fixes if any
Requirements
- iOS 8 and later
- Swift 5 & Xcode 10.2
- If you wish to work with Swift 2.3, check out branch
swift23
Getting Started
Install using CocoaPods
Just add the following line in to your pod file:
pod 'PeekView'
Manual Install
Drag and drop folder named Source in your project and you're done.
Usage
- Add
UILongPressGestureRecognizerto the view you want to peek (i.e table view cell, image, hypertext, etc.) - Create a
UIViewControllerinstance as the content of your peek view; then set your desired frame for the content view. It's recommended to leave a 15px padding for both left and right margin of your content view. - If you want to include preview actions, prepare an array containing title of the buttons and its preview style. Don't forget to prepare completion handlers for when each button is tapped.
Sample snippet:
let options = [
PeekViewAction(title: "Option 1", style: .Destructive),
PeekViewAction(title: "Option 2", style: .Default),
PeekViewAction(title: "Option 3", style: .Selected) ]
PeekView().viewForController(
parentViewController: self,
contentViewController: controller,
expectedContentViewFrame: frame,
fromGesture: gestureRecognizer,
shouldHideStatusBar: true,
withOptions: options,
completionHandler: { optionIndex in
switch optionIndex {
case 0:
print("Option 1 selected")
case 1:
print("Option 2 selected")
case 2:
print("Option 3 selected")
default:
break
}
})
Be sure to check out the demo code for better understanding of the usage.
As for Objective-C integration, a slightly different static function should be used, in which the menuOptions array is expected to be an NSArray of NSDictionary's. Please check the snippet below:
NSArray *options = @[@{@"Option 1": @(PeekViewActionStyleDefault)},
@{@"Option 2": @(PeekViewActionStyleDestructive)}];
UIViewController *contentViewController = [self.storyboard instantiateViewControllerWithIdentifier:@"previewVC"];
[PeekView viewForControllerWithParentViewController:self
contentViewController:contentViewController
expectedContentViewFrame:CGRectMake(0, 0, 280, 400)
fromGesture:gesture
shouldHideStatusBar:YES
withOptions:options
completionHandler:nil];
ARC
PeekView uses ARC. If you are using PeekView in a non-arc project, you
will need to set a -fobjc-arc compiler flag on every PeekView source files. To set a
compiler flag in Xcode, go to your active target and select the "Build Phases" tab. Then select
PeekView source files, press Enter, insert -fobjc-arc and then "Done" to enable ARC
for PeekView.
Contributing
Contributions for bug fixing or improvements are welcome. Feel free to submit a pull request.
Licence
PeekView is available under the MIT license. See the LICENSE file for more info.
*Note that all licence references and agreements mentioned in the PeekView README section above
are relevant to that project's source code only.