JonyFang / FFPopup
- пятница, 14 декабря 2018 г. в 00:17:21
Objective-C
🎉 Presenting custom views as a popup in iOS.
FFPopup is a lightweight library for presenting custom views as a popup.
Support several popup show types
Support several popup dismiss types
Layout the popup in the horizontal direction
Layout the popup in the vertical direction
Controled whether to allow interaction with the underlying view
Others
To run the Example
project, clone the Repo, and start Example
in Xcode.
$ git clone https://github.com/JonyFang/FFPopup.git
$ cd FFPopup/Example
$ open FFPopup_Example.xcworkspace
CocoaPods is a dependency manager, which automates and simplifies the process of using 3rd-party libraries like FFPopup
in your projects. First, add the following line to your Podfile:
pod 'FFPopup'
If you want to use the latest features of FFPopup use normal external source dependencies.
pod 'FFPopup', :git => 'https://github.com/JonyFang/FFPopup.git'
This pulls from the master branch directly.
Second, install FFPopup
into your project:
pod install
Alternatively you can directly add the FFPopup.h
and FFPopup.m
source files to your project.
FFPopup.h
and FFPopup.m
onto your project (use the "Product Navigator view"
). Make sure to select Copy items
when asked if you extracted the code archive outside of your project.FFPopup
wherever you need it with #import "FFPopup.h"
.Even though FFPopup
is written in Objective-C, it can be used in Swift with no hassle. If you use CocoaPods add the following line to your Podfile:
use_frameworks!
If you added FFPopup
manually, just add a bridging header file to your project with the FFPopup
header included.
Import the library where you want to use it.
#import <FFPopup.h>
[[FFPopup popupWithContentView:self.contentView] show];
// Do something...
[FFPopup dismissPopupForView:self.contentView animated: YES];
import FFPopup
FFPopup.init(contentView:self.contentView).show()
// Do something...
FFPopup.dismiss(for:self.contentView animated:true)
Animation transition for presenting contentView. Controled how the popup will be presented.
The default value is FFPopupShowType_BounceInFromTop
.
FFPopupShowType |
---|
FFPopupShowType_None |
FFPopupShowType_FadeIn |
FFPopupShowType_GrowIn |
FFPopupShowType_ShrinkIn |
FFPopupShowType_SlideInFromTop |
FFPopupShowType_SlideInFromBottom |
FFPopupShowType_SlideInFromLeft |
FFPopupShowType_SlideInFromRight |
FFPopupShowType_BounceIn |
FFPopupShowType_BounceInFromTop |
FFPopupShowType_BounceInFromBottom |
FFPopupShowType_BounceInFromLeft |
FFPopupShowType_BounceInFromRight |
Animation transition for dismissing contentView. Controled how the popup will be dismissed.
The default value is FFPopupDismissType_BounceOutToBottom
.
FFPopupDismissType |
---|
FFPopupDismissType_None |
FFPopupDismissType_FadeOut |
FFPopupDismissType_GrowOut |
FFPopupDismissType_ShrinkOut |
FFPopupDismissType_SlideOutToTop |
FFPopupDismissType_SlideOutToBottom |
FFPopupDismissType_SlideOutToLeft |
FFPopupDismissType_SlideOutToRight |
FFPopupDismissType_BounceOut |
FFPopupDismissType_BounceOutToTop |
FFPopupDismissType_BounceOutToBottom |
FFPopupDismissType_BounceOutToLeft |
FFPopupDismissType_BounceOutToRight |
Mask prevents background touches from passing to underlying views. Controled whether to allow interaction with the underlying view.
The default value is FFPopupMaskType_Dimmed
.
FFPopupMaskType |
---|
FFPopupMaskType_None |
FFPopupMaskType_Clear |
FFPopupMaskType_Dimmed |
Property Name | Description | Default Value |
---|---|---|
dimmedMaskAlpha | Overrides alpha value for dimmed mask. | 0.5 |
showInDuration | Overrides animation duration for show in. | 0.15 |
dismissOutDuration | Overrides animation duration for dismiss out. | 0.15 |
shouldDismissOnBackgroundTouch | If YES , the popup will dismiss when background is touched. |
YES |
shouldDismissOnContentTouch | If YES , the popup will dismiss when content view is touched. |
NO |
/**
A block to be executed when showing animation started.
The default value is nil.
*/
@property (nonatomic, copy, nullable) void(^willStartShowingBlock)(void);
/**
A block to be executed when showing animation finished.
The default value is nil.
*/
@property (nonatomic, copy, nullable) void(^didFinishShowingBlock)(void);
/**
A block to be executed when dismissing animation started.
The default value is nil.
*/
@property (nonatomic, copy, nullable) void(^willStartDismissingBlock)(void);
/**
A block to be executed when dismissing animation finished.
The default value is nil.
*/
@property (nonatomic, copy, nullable) void(^didFinishDismissingBlock)(void);
Creat a new popup with custom values.
/**
Convenience Initializers
Creat a new popup with `contentView`.
*/
+ (FFPopup *)popupWithContentView:(UIView *)contentView;
/**
Convenience Initializers
Creat a new popup with custom values.
@param contentView The view you want to appear in popup.
@param showType The default value is `FFPopupShowType_BounceInFromTop`.
@param dismissType The default value is `FFPopupDismissType_BounceOutToBottom`.
@param maskType The default value is `FFPopupMaskType_Dimmed`.
@param shouldDismissOnBackgroundTouch The default value is `YES`.
@param shouldDismissOnContentTouch The default value is `NO`.
*/
+ (FFPopup *)popupWithContentView:(UIView *)contentView
showType:(FFPopupShowType)showType
dismissType:(FFPopupDismissType)dismissType
maskType:(FFPopupMaskType)maskType
dismissOnBackgroundTouch:(BOOL)shouldDismissOnBackgroundTouch
dismissOnContentTouch:(BOOL)shouldDismissOnContentTouch;
/**
Show popup with center layout.
`FFPopupVerticalLayout_Center` & `FFPopupHorizontalLayout_Center`
Showing animation is determined by `showType`.
*/
- (void)show;
/**
Show popup with specified layout.
Showing animation is determined by `showType`.
*/
- (void)showWithLayout:(FFPopupLayout)layout;
/**
Show and then dismiss popup after `duration`.
If duration is `0.0` or `less`, it will be considered infinity.
*/
- (void)showWithDuration:(NSTimeInterval)duration;
/**
Show popup with specified `layout` and then dismissed after `duration`.
If duration is `0.0` or `less`, it will be considered infinity.
*/
- (void)showWithLayout:(FFPopupLayout)layout duration:(NSTimeInterval)duration;
/**
Show popup at point in view's coordinate system.
If view is nil, will use screen base coordinates.
*/
- (void)showAtCenterPoint:(CGPoint)point inView:(UIView *)view;
/**
Show popup at point in view's coordinate system and then dismissed after duration.
If view is nil, will use screen base coordinates.
If duration is `0.0` or `less`, it will be considered infinity.
*/
- (void)showAtCenterPoint:(CGPoint)point inView:(UIView *)view duration:(NSTimeInterval)duration;
/**
Dismiss popup.
Use `dismissType` if animated is `YES`.
*/
- (void)dismissAnimated:(BOOL)animated;
/**
Dismiss all the popups in the app.
*/
+ (void)dismissAllPopups;
/**
Dismiss the popup for contentView.
*/
+ (void)dismissPopupForView:(UIView *)view animated:(BOOL)animated;
/**
Dismiss super popup.
Iterate over superviews until you find a `FFPopup` and dismiss it.
*/
+ (void)dismissSuperPopupIn:(UIView *)view animated:(BOOL)animated;
This is the to-do list for the FFPopup project. You can join us to become a contributor.
See the CONTRIBUTING file for contributing guidelines.
My app Time Card -Countdown (Never Forget Important Days) is using FFPopup. You can download it and try it on your multiple devices to experience the effect.
FFPopup
is available under the MIT license. See the LICENSE file for more info.