# BottomPopup

**Repository Path**: zero-time/BottomPopup

## Basic Information

- **Project Name**: BottomPopup
- **Description**: 222sdtestsdtsd
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-06-04
- **Last Updated**: 2024-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BottomPopup

**BottomPopup provides a popup-like presentation style to any view controller**

![](https://img.shields.io/badge/version-0.6.0-blue.svg)
![](https://img.shields.io/badge/platform-ios-lightgrey.svg)
![](https://img.shields.io/badge/swift-4.2-orange.svg)
![](https://img.shields.io/badge/Contact-ergunemr%40gmail.com-yellowgreen.svg)

## What does BottomPopup do?
It is a custom presentation style for view controllers to present any view controller with slide animation from bottom of the screen.

## What does it look like ?
Actually depends on your view controller, a real world examples can be seen below;

![](https://media.giphy.com/media/Cjtdn4GdOy4F80voe0/giphy.gif) | ![](https://media.giphy.com/media/58FNuaDbPyyc8IdRtB/giphy.gif)

## How is it set up?

**Using CocoaPods (Recommended)**

Add below line to your Podfile;

```
pod 'BottomPopup'
```

Then you can install it with pod install command.

**Manual**

Download the project, just drag and drop classes under **BottomPopupController** file to your project.

## How is it used?

After install, simply make your view controller subclass of **BottomPopupViewController.**  

For navigation controllers, it works exactly in same way, make your navigation controller subclass of **BottomPopupNavigationController.**

Congratulations, your view controller is ready to show 🎉

Then you can present your controller with native **presentViewController:animated:completion:** method, bottom popup controller will handle rest.

## Customization

Bottom popup comes with couple of customizable properties. Since your view controller subclass of BottomPopupViewController now, **you can override following properties in your view controller** to change behaviour;

* **_popupShouldDismissInteractivelty: Bool_**
  
  Determines the popup should dismiss whether interactively or not. If it is set to yes, user can dismiss popup with pulling down it down. Default is YES
* **_popupHeight: BOOL_**
  
  Height value. Default is 377 pt. For example you can return UIScreen.main.bounds.size.height to give it full screen height.
* **_popupTopCornerRadius: BOOL_**
  
  Corner radius of popup. Default is 10pt
* **_popupPresentDuration: Double_**
   
   Present animation duration. Default is 0.5 sec
* **_popupDismissDuration: Double_**
   
   Dismiss animation duration. Default is 0.5 sec

* **_popupDimmingViewAlpha: CGFloat_**
   
   Target alpha value of the black-colored dimming view after present animation. Default is 0.5

* **_popupShouldBeganDismiss: BOOL_**
   
   Basically controls whether user can close the popup or not. You can change this variable at the runtime to control dismiss behaviour on spesific actions. Tap on dimming view, swipe down on dimming view and pan gesture on popup dont work if this variable set to false during these actions

* **_popupViewAccessibilityIdentifier: String_**
   
   Accessibility identifier of popup's view. Default is _bottomPopupView_
   
   You can see how changing of these properties changes popup's behaviour below.
   (Gifs are extracted from example project)
    
    UIViewController  | UINavigationController
    --- | ---
    ![](https://media.giphy.com/media/kSbDw36fJUmbDnbcoj/giphy.gif) | ![](https://media.giphy.com/media/kEEduYnDbfS9eC9pXF/giphy.gif)

## Delegate

If you want to track popup lifecycle or current dismiss interaction percent, you can set popupDelegate;

```
popupVC.popupDelegate = self
```

Methods;
```
func bottomPopupViewLoaded()
func bottomPopupWillAppear()
func bottomPopupDidAppear()
func bottomPopupWillDismiss()
func bottomPopupDidDismiss()
func bottomPopupDismissInteractionPercentChanged(from oldValue: CGFloat, to newValue: CGFloat)
```

 ## Questions or Advices
 Just send me an email (ergunemr@gmail.com)