135 lines
4.1 KiB
Markdown
135 lines
4.1 KiB
Markdown
|
<img src="http://oo8l3jrvb.bkt.clouddn.com/0921_left_zhPopupController.png" alt="zhPopupController" title="zhPopupController">
|
|||
|
|
|
|||
|
|
[](https://travis-ci.org/snail-z/zhPopupController)
|
|||
|
|
[](http://cocoapods.org/pods/zhPopupController)
|
|||
|
|
[](http://cocoapods.org/pods/zhPopupController)
|
|||
|
|
[](http://cocoapods.org/pods/zhPopupController)
|
|||
|
|
|
|||
|
|
Popup your custom view is easy, support custom mask style, transition effects and gesture to drag.
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 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', '~> 1.0'
|
|||
|
|
|
|||
|
|
end
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Preview
|
|||
|
|
|
|||
|
|
<img src="htt://github.com/snail-z/zhPopupController/blob/master/Preview/_zhPopupController.gif?raw=true" width="204px" height="365px">
|
|||
|
|
|
|||
|
|
## Usage
|
|||
|
|
|
|||
|
|
* Direct use of zh_popupController popup your custom view.
|
|||
|
|
``` objc
|
|||
|
|
[self.popupController showInView:self.view.window completion:NULL];
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
* Customize.
|
|||
|
|
```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 dismiss automatically.
|
|||
|
|
|
|||
|
|
```objc
|
|||
|
|
/// The view will disappear after `dismissAfterDelay` seconds，default is 0 will not disappear
|
|||
|
|
@property (nonatomic, assign) NSTimeInterval dismissAfterDelay;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
-----
|
|||
|
|
|
|||
|
|
- Update
|
|||
|
|
|
|||
|
|
Observe to keyboard changes will change contentView layout
|
|||
|
|
|
|||
|
|
New **`keyboardOffsetSpacing`** properties. 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.
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
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];
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
<img src="https://github.com/snail-z/zhPopupController/blob/master/Preview/_zhPopupController_up.gif?raw=true" width="204px" height="365px">
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
-----
|
|||
|
|
|
|||
|
|
- Update
|
|||
|
|
|
|||
|
|
- Support present/dismiss slide style
|
|||
|
|
|
|||
|
|
- When system is larger than iOS 8 will use of UIVisualEffectView to do mask blur effect.
|
|||
|
|
|
|||
|
|
<img src="https://github.com/snail-z/zhPopupController/blob/master/Preview/_zhPopupController_ios11.gif?raw=true?raw=true" width="216px" height="427px">
|
|||
|
|
|
|||
|
|
-----
|
|||
|
|
|
|||
|
|
- Update **(November 20, 2017 v1.0.2)**
|
|||
|
|
- New method `- (void)fadeDismiss` for fade out of your content view.
|
|||
|
|
|
|||
|
|
- In 1.0.2 `zhPopupSlideStyleShrinkInOut` will be deprecated, You should use `zhPopupSlideStyleShrinkInOut1` or `zhPopupSlideStyleShrinkInOut2`
|
|||
|
|
|
|||
|
|
|
|||
|
|
## Author
|
|||
|
|
|
|||
|
|
snail-z, haozhang0770@163.com
|
|||
|
|
|
|||
|
|
## License
|
|||
|
|
|
|||
|
|
zhPopupController is available under the MIT license. See the LICENSE file for more info.
|
|||
|
|
|
|||
|
|
|