corin8823/Popover

Popover is a balloon library like Facebook app. It is written in pure swift.

Swift

2,108

164 commits

updated Jun 15, 2024

See the code

README

Popover

CI Status Version License Platform

Description and appetize.io`s DEMO

Usage

To run the example project, clone the repo, and run pod install from the Example directory first.

Simple

let startPoint = CGPoint(x: self.view.frame.width - 60, y: 55)
let aView = UIView(frame: CGRect(x: 0, y: 0, width: self.view.frame.width, height: 180))
let popover = Popover()
popover.show(aView, point: startPoint)

Custom

@IBOutlet weak var leftBottomButton: UIButton!

let width = self.view.frame.width / 4
let aView = UIView(frame: CGRect(x: 0, y: 0, width: width, height: width))
let options = [
  .type(.up),
  .cornerRadius(width / 2),
  .animationIn(0.3),
  .blackOverlayColor(UIColor.red),
  .arrowSize(CGSize.zero)
  ] as [PopoverOption]
let popover = Popover(options: options, showHandler: nil, dismissHandler: nil)
popover.show(aView, fromView: self.leftBottomButton)

Requirements

  • iOS 9.0+
  • Swift 5

Installation

CocoaPods (iOS 8+)

Popover is available through CocoaPods. To install it, simply add the following line to your Podfile:

use_frameworks!
pod "Popover"

Carthage (iOS 8+)

You can use Carthage to install Popover by adding it to your Cartfile:

github "corin8823/Popover"

Manual Installation

The class file required for Popover is located in the Classes folder in the root of this repository as listed below:

Popover.swift

Customization

Enum

  • case arrowSize(CGSize)
  • case animationIn(NSTimeInterval)
  • case animationOut(NSTimeInterval)
  • case cornerRadius(CGFloat)
  • case sideEdge(CGFloat)
  • case blackOverlayColor(UIColor)
  • case overlayBlur(UIBlurEffectStyle)
  • case type(Popover.PopoverType)
  • case color(UIColor)
  • case dismissOnBlackOverlayTap(Bool)
  • case showBlackOverlay(Bool)

Property

  • arrowSize: CGSize = CGSize(width: 16.0, height: 10.0)
  • animationIn: NSTimeInterval = 0.6
  • animationOut: NSTimeInterval = 0.3
  • cornerRadius: CGFloat = 6.0
  • sideEdge: CGFloat = 20.0
  • popoverType: PopoverType = .down
  • blackOverlayColor: UIColor = UIColor(white: 0.0, alpha: 0.2)
  • overlayBlur: UIBlurEffect?
  • popoverColor: UIColor = UIColor.white

Acknowledgments

Inspired by DXPopover in xiekw2010

License

Popover is available under the MIT license. See the LICENSE file for more info.

corin8823/Popover

Popover is a balloon library like Facebook app. It is written in pure swift.

Swift

2,108

164 commits

updated Jun 15, 2024

See the code

README

Popover

CI Status Version License Platform

Description and appetize.io`s DEMO

Usage

To run the example project, clone the repo, and run pod install from the Example directory first.

Simple

let startPoint = CGPoint(x: self.view.frame.width - 60, y: 55)
let aView = UIView(frame: CGRect(x: 0, y: 0, width: self.view.frame.width, height: 180))
let popover = Popover()
popover.show(aView, point: startPoint)

Custom

@IBOutlet weak var leftBottomButton: UIButton!

let width = self.view.frame.width / 4
let aView = UIView(frame: CGRect(x: 0, y: 0, width: width, height: width))
let options = [
  .type(.up),
  .cornerRadius(width / 2),
  .animationIn(0.3),
  .blackOverlayColor(UIColor.red),
  .arrowSize(CGSize.zero)
  ] as [PopoverOption]
let popover = Popover(options: options, showHandler: nil, dismissHandler: nil)
popover.show(aView, fromView: self.leftBottomButton)

Requirements

  • iOS 9.0+
  • Swift 5

Installation

CocoaPods (iOS 8+)

Popover is available through CocoaPods. To install it, simply add the following line to your Podfile:

use_frameworks!
pod "Popover"

Carthage (iOS 8+)

You can use Carthage to install Popover by adding it to your Cartfile:

github "corin8823/Popover"

Manual Installation

The class file required for Popover is located in the Classes folder in the root of this repository as listed below:

Popover.swift

Customization

Enum

  • case arrowSize(CGSize)
  • case animationIn(NSTimeInterval)
  • case animationOut(NSTimeInterval)
  • case cornerRadius(CGFloat)
  • case sideEdge(CGFloat)
  • case blackOverlayColor(UIColor)
  • case overlayBlur(UIBlurEffectStyle)
  • case type(Popover.PopoverType)
  • case color(UIColor)
  • case dismissOnBlackOverlayTap(Bool)
  • case showBlackOverlay(Bool)

Property

  • arrowSize: CGSize = CGSize(width: 16.0, height: 10.0)
  • animationIn: NSTimeInterval = 0.6
  • animationOut: NSTimeInterval = 0.3
  • cornerRadius: CGFloat = 6.0
  • sideEdge: CGFloat = 20.0
  • popoverType: PopoverType = .down
  • blackOverlayColor: UIColor = UIColor(white: 0.0, alpha: 0.2)
  • overlayBlur: UIBlurEffect?
  • popoverColor: UIColor = UIColor.white

Acknowledgments

Inspired by DXPopover in xiekw2010

License

Popover is available under the MIT license. See the LICENSE file for more info.

Project health

Overall

3.2/10

Maintained

0/10

Code review

4/10
OpenSSF Scorecard

Significant stargazers

Roman Podymov

129 followers · starred May 2025

Dwight Watson

225 followers · starred Aug 2015

Michael Rebello

51 followers · starred Aug 2015

Anthony Miller

73 followers · starred Oct 2016