zhPopupController

Help you pop up custom views easily. and support pop-up animation, layout position, mask effect and gesture interaction etc.

1482
264
Objective-C

Language
Version
License
Platform

zhPopupController can help you pop up custom views easily. It supports custom pop-up animations, layout positions, mask effects, keyboard monitoring, gesture interaction, etc. it API simple and easy to use.

Version 2.0

zhPopupController version 2.0 has been optimized and refactored. Some methods and properties in version 1.0 are no longer compatible. Please upgrade with caution.
The swift version is more lightweight and concise. if you want to know more, please see here.

Swift - OverlayController

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

  • Requires iOS 8.0 or later
  • Requires Automatic Reference Counting (ARC)

Installation

zhPopupController is available through CocoaPods. To install
it, simply add the following line to your Podfile:

platform :ios, '8.0'
use_frameworks!

target 'You Project' do
    
	pod 'zhPopupController', '~> 2.0'
    
end

Preview

Usage

  • Designated initializer,Must set your content view and its size. Bind the view to a popup controller,one-to-one
    _popupController = [[zhPopupController alloc] initWithView:customView size:alert.bounds.size];
    _popupController.presentationStyle = zhPopupSlideStyleTransform;
    _popupController.presentationTransformScale = 1.25;
    _popupController.dismissonTransformScale = 0.85;
    // ...
    [_popupController showInView:self.view.window completion:NULL];
    

  • Support following keyboard popup and hide

    If you want to make the animation consistent:

    You need to call the method “becomeFirstResponder()” in “willPresentBlock”, don’t call it before that.

    You need to call the method “resignFirstResponder()” in “willDismissBlock”.

    /// default is NO. if YES, Will adjust view position when keyboard changes
    @property (nonatomic, assign) BOOL keyboardChangeFollowed;
    
    /// default is NO. if the view becomes first responder,you need set YES to keep the animation consistent
    @property (nonatomic, assign) BOOL becomeFirstResponded;
    
    _popupController.becomeFirstResponded = YES;
    _popupController.keyboardChangeFollowed = YES;
    _popupController.willPresentBlock = ^(zhPopupController * _Nonnull popupController) {
    	[textField becomeFirstResponder];
    };
            
    _popupController.willDismissBlock = ^(zhPopupController * _Nonnull popupController) {
    	[textField resignFirstResponder];
    };
    
    //...
    [_popupController show];
    
  • Support adjust the spacing between with the keyboard.by keyboardOffsetSpacing. You can through it adjust the spacing relative to the keyboard when the keyboard appears. default is 0, The pan gesture will be invalid when the keyboard appears.

    /// Adjust the spacing between with the keyboard
    @property (nonatomic, assign) CGFloat keyboardOffsetSpacing;
    

  • Support present/dismiss slide style. bypresentationStyle dismissonStyle

  • Support Set popup view display position. by layoutType

  • Support Set popup view mask style. by maskType

  • Support set popup view priority. default is zhPopupWindowLevelNormal windowLevel

  • Support adjust the layout position by offsetSpacing

  • Support gesture dragging,default is NO. if YES, Popup view will allow to drag panGestureEnabled

  • Support dismiss automatically. the view will disappear after dismissAfterDelay seconds,default is 0 will not disappear

    /// Set popup view mask style. default is zhPopupMaskTypeBlackOpacity (maskAlpha: 0.5)
    @property (nonatomic, assign) zhPopupMaskType maskType;
    
    /// Set popup view display position. default is zhPopupLayoutTypeCenter
    @property (nonatomic, assign) zhPopupLayoutType layoutType;
    
    /// Set popup view present slide style. default is zhPopupSlideStyleFade
    @property (nonatomic, assign) zhPopupSlideStyle presentationStyle;
    
    /// Set popup view dismiss slide style. default is `presentationStyle`
    @property (nonatomic, assign) zhPopupSlideStyle dismissonStyle;
    
    /// Set popup view priority. default is zhPopupWindowLevelNormal
    @property (nonatomic, assign) zhPopupWindowLevel windowLevel;
    
    /// The view will disappear after `dismissAfterDelay` seconds,default is 0 will not disappear
    @property (nonatomic, assign) NSTimeInterval dismissAfterDelay;
    
    /// default is NO. if YES, Popup view will allow to drag
    @property (nonatomic, assign) BOOL panGestureEnabled;
    
    /// Adjust the layout position by `offsetSpacing`
    @property (nonatomic, assign) CGFloat offsetSpacing;
    

    See demo for more usage.

Author

snail-z, [email protected]

License

zhPopupController is available under the MIT license. See the LICENSE file for more info.