Awesome
ARSPopover
Universal popover for iPhone and iPad that you can use in your projects. No custom drawing, no custom elements - everything is purely native.
iPhone | iPad |
---|---|
Installation
CocoaPods
To install with CocoaPods, copy and paste this in your Podfile file:
platform :ios, '8.3'
pod 'ARSPopover', '~> 2.0'
Non-CocoaPods way
You can always to do the old way - just drag the source files into your projects and you are good to go.
Usage
Sample usage of the ARSPopover might look like this:
- (IBAction)showPopoverWithWebView:(id)sender {
ARSPopover *popoverController = [ARSPopover new];
popoverController.sourceView = self.buttonWithWebView;
popoverController.sourceRect = CGRectMake(CGRectGetMidX(self.buttonWithWebView.bounds), CGRectGetMaxY(self.buttonWithWebView.bounds), 0, 0);
popoverController.contentSize = CGSizeMake(400, 600);
popoverController.arrowDirection = UIPopoverArrowDirectionUp;
[self presentViewController:popoverController animated:YES completion:^{
[popoverController insertContentIntoPopover:^(ARSPopover *popover, CGSize popoverPresentedSize, CGFloat popoverArrowHeight) {
CGFloat originX = 0;
CGFloat originY = 0;
CGFloat width = popoverPresentedSize.width;
CGFloat height = popoverPresentedSize.height - popoverArrowHeight;
CGRect frame = CGRectMake(originX, originY, width, height);
UIWebView *webView = [[UIWebView alloc] initWithFrame:frame];
webView.scalesPageToFit = YES;
[webView loadRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@"https://google.com"]]];
[popover.view addSubview:webView];
}];
}];
}
Required properties' configurations
In order to get a working popover, you need to specify next properties:
popoverController.sourceView
- The view containing the anchor rectangle for the popover.
popoverController.sourceView = self.buttonWithWebView;
popoverController.sourceRect
- The rectangle in the specified view in which to anchor the popover.
popoverController.sourceRect = CGRectMake(CGRectGetMidX(self.buttonWithWebView.bounds), CGRectGetMaxY(self.buttonWithWebView.bounds), 0, 0);
popoverController.contentSize
- The preferred size for the popover’s view.
popoverController.contentSize = CGSizeMake(400, 600);
- And the last, most important thing - you have to call method
insertContentIntoPopover
and pass a block of code, which should add subviews to popover's view you wish to see.
Be sure to call this method only after you have presented popup. Otherwise you might get wrong size in popoverPresentedSize.
[popoverController insertContentIntoPopover:^(ARSPopover *popover, CGSize popoverPresentedSize, CGFloat popoverArrowHeight) {
CGFloat originX = 0;
CGFloat originY = 0;
CGFloat width = popoverPresentedSize.width;
CGFloat height = popoverPresentedSize.height - popoverArrowHeight;
CGRect frame = CGRectMake(originX, originY, width, height);
UIWebView *webView = [[UIWebView alloc] initWithFrame:frame];
webView.scalesPageToFit = YES;
[webView loadRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@"https://google.com"]]];
[popover.view addSubview:webView];
}];
Optional delegate methods
You can conform to ARSPopoverDelegate
protocol, so that you could receive delegate calls from UIPopoverPresentationController
. You can implement following delegate methods:
- (void)popoverPresentationController:(UIPopoverPresentationController *)popoverPresentationController willRepositionPopoverToRect:(inout CGRect *)rect inView:(inout UIView *__autoreleasing *)view;
- (BOOL)popoverPresentationControllerShouldDismissPopover:(UIPopoverPresentationController *)popoverPresentationController;
- (void)popoverPresentationControllerDidDismissPopover:(UIPopoverPresentationController *)popoverPresentationController;
License
ARSPopover is released under the MIT license. See LICENSE for details.