ars

ARSPopover

Universal popover for iPhone and iPad.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

74

Maintenance

Last Commit

6yrs ago

Contributors

3

Package

Dependencies

0

License

MIT

Categories

Readme

ARSPopover GitHub license

Universal popover for iPhone and iPad that you can use in your projects. No custom drawing, no custom elements - everything is purely native.

iPhoneiPad
ARSPopover-iPhoneARSPopover-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.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100