Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/snail-z/zhpopupcontroller
Help you pop up custom views easily. and support pop-up animation, layout position, mask effect and gesture interaction etc.
https://github.com/snail-z/zhpopupcontroller
actionsheet alert custom-view drag drop elastic fullscreen gesture mask maskedinput overlay popup present qzone share sheet sidebar sina spring
Last synced: 29 days ago
JSON representation
Help you pop up custom views easily. and support pop-up animation, layout position, mask effect and gesture interaction etc.
- Host: GitHub
- URL: https://github.com/snail-z/zhpopupcontroller
- Owner: snail-z
- License: mit
- Created: 2017-02-08T04:53:19.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2020-04-03T00:52:24.000Z (over 4 years ago)
- Last Synced: 2024-10-15T03:40:29.635Z (29 days ago)
- Topics: actionsheet, alert, custom-view, drag, drop, elastic, fullscreen, gesture, mask, maskedinput, overlay, popup, present, qzone, share, sheet, sidebar, sina, spring
- Language: Objective-C
- Homepage:
- Size: 7.28 MB
- Stars: 1,497
- Watchers: 42
- Forks: 259
- Open Issues: 40
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/snail-z/zhPopupController)
[](http://cocoapods.org/pods/zhPopupController)
[](http://cocoapods.org/pods/zhPopupController)
[](http://cocoapods.org/pods/zhPopupController)
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](https://github.com/snail-z/OverlayController).
**Swift - [OverlayController](https://github.com/snail-z/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](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
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
```objc
_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".
```objc
/// 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;
```
```objc
_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.
```objc
/// Adjust the spacing between with the keyboard
@property (nonatomic, assign) CGFloat keyboardOffsetSpacing;
```
-----
- Support present/dismiss slide style. by`presentationStyle` `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
```objc
/// 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.