Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shin8484/PopupWindow
PopupWindow is a simple Popup using another UIWindow in Swift
https://github.com/shin8484/PopupWindow
popup popup-window swift toast
Last synced: 5 days ago
JSON representation
PopupWindow is a simple Popup using another UIWindow in Swift
- Host: GitHub
- URL: https://github.com/shin8484/PopupWindow
- Owner: shin8484
- License: mit
- Created: 2017-12-22T08:20:23.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-09-22T15:25:40.000Z (about 6 years ago)
- Last Synced: 2024-04-24T18:57:35.002Z (8 months ago)
- Topics: popup, popup-window, swift, toast
- Language: Swift
- Homepage:
- Size: 84 MB
- Stars: 415
- Watchers: 12
- Forks: 29
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - PopupWindow - PopupWindow is a simple Popup using another UIWindow in Swift. (UI / Popup)
- awesome-ios-star - PopupWindow - PopupWindow is a simple Popup using another UIWindow in Swift. (UI / Popup)
README
# PopupWindow
[](http://cocoapods.org/pods/PopupWindow)
[](http://cocoapods.org/pods/PopupWindow)
[](https://github.com/Carthage/Carthage)
[](http://cocoapods.org/pods/PopupWindow)
PopupWindow is a simple Popup using another UIWindow
## Feature
- PopupWindow can be displayed at the top or bottom of the screen.
- Popup can set margins, cornerRadius, blur, etc.
- When displaying blur, you can't touch the below contents.
- By erasing blur, you can touch the below contents.
- Popup are displayed on another window, so you can leave Popup even when screen transitions.
TopToast | BottomToast | TopCard | BottomCard | Example
--- | --- | --- | --- | ---
 |  |  |  | 
## Installation
### CocoaPods
Add PopupWindow to your Podfile:
```
pod 'PopupWindow'
```
### Carthage
Add PopupWindow to your Cartfile:
```
github "shin8484/PopupWindow"
```
## Usage
When displaying popup in another window, please call first `PopupWindowManager` `changeKeyWindow(rootViewController: UIViewController)`
```Swift
PopupWindowManager.shared.changeKeyWindow(rootViewController: UIViewController())
```
### Create and show show
Create a PopupItem in the ViewController where you want to display the popup and call the method of BasePopupViewController
```Swift
let popupOption = PopupOption(shapeType: .roundedCornerTop(cornerSize: 8), viewType: .toast, direction: .bottom)
let popupItem = PopupItem(view: loginView,
height: Const.firstViewFrame.height,
maxWidth: 500,
popupOption: popupOption)
```
First popup implementation is included in BasePopupViewController's `loadView`, `viewDidAppear`.
If you want to create the next popup, please call `showPopupView()`.
```Swift
class SampleViewController: BasePopupViewController {
override open func loadView() {
super.loadView()
setupPopupContainerView()
}
override open func viewDidAppear(_ animated: Bool) {
super.viewDidAppear(animated)
makePopupView(with: item)
showPopupView(duration: item.duration, curve: .easeInOut, delayFactor: 0.0)
}
}
```
### Transform & Replace
Replace the display contents, and perform deformation to the specified size.
By using `PopupItem`, you can specify content contents and size.
```Swift
transformPopupView(duration: Const.transformDuration, curve: .easeInOut, popupItem: popupItem) { [weak self] _ in
guard let me = self else { return }
me.replacePopupView(with: popupItem)
me.dismissPopupView(duration: 3.3, curve: .easeInOut, delayFactor: 0.9, direction: .top) { _ in }
}
```
### Dismiss
Specify hide animation direction with `PopupViewDirection`
```Swift
dismissPopupView(duration: 3.3, curve: .easeInOut, delayFactor: 0.9, direction: .bottom) { _ in
PopupWindowManager.shared.changeKeyWindow(rootViewController: nil)
}
```
### PopupItem
PopupItem and PopupOption are struct to set up a popup, View, size, direction, whether it is rounded, margin, blurred or not, duration, maxWidth, type
```Swift
public struct PopupItem {
public let view: UIView
public let height: CGFloat
public let maxWidth: CGFloat
public let landscapeSize: CGSize?
public let popupOption: PopupOption
}
```
```Swift
public struct PopupOption {
public let shapeType: ShapeType
public let viewType: ViewType
public let direction: PopupViewDirection
public let margin: CGFloat
public let hasBlur: Bool
public let duration: TimeInterval
public let canTapDismiss: Bool
}
```
## Landscape
### maxWidth
By setting maxWidth with popupitem's initializer, you can set the maximum width of the popup in landscape mode.
### landscapeSize
You can set popup size at landscape.
The size changes only when landscape size is set, and the default is nil.
Using landscapeSize and SizeClass, you can customize PopupVIew that has the widest width like GIF below when rotating.
## Requirements
- iOS 10.0+
- Xcode 9.1+
- Swift 3.0.1+
## LICENSE
Under the MIT license. See LICENSE file for details.