Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/prasad1120/elegantpopover
Highly customisable popover with multiple borders, borders styles (color and gradient) and arrow styles in iOS.
https://github.com/prasad1120/elegantpopover
cocoapod cocoapods ios popover popovers resume-project swift ui ui-components
Last synced: 4 months ago
JSON representation
Highly customisable popover with multiple borders, borders styles (color and gradient) and arrow styles in iOS.
- Host: GitHub
- URL: https://github.com/prasad1120/elegantpopover
- Owner: prasad1120
- License: mit
- Created: 2020-07-04T06:12:36.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-07-06T06:15:12.000Z (over 4 years ago)
- Last Synced: 2024-09-29T22:21:03.388Z (5 months ago)
- Topics: cocoapod, cocoapods, ios, popover, popovers, resume-project, swift, ui, ui-components
- Language: Swift
- Homepage:
- Size: 2.6 MB
- Stars: 15
- Watchers: 2
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Elegant Popover
Highly customisable popovers with multiple borders, borders styles (color and gradient) and arrow styles in iOS.
## Features
- [x] Border with Color or Gradient (Any layer).
- [x] Multiple Borders for a Popover.
- [x] Customisable Arrow shape.
- [x] Solid and Outlined Arrow.
## Requirements
- Swift 4
- iOS 11 and above
## Installation
ElegantPopover is available on [CocoaPods](https://cocoapods.org/pods/ElegantPopover).
Add this line to your `Podfile`.
~~~
pod 'ElegantPopover'
~~~
Run `pod install`.
## Dependencies
This library depends on [ClippingBezier](https://github.com/adamwulf/ClippingBezier) library.
## Usage
```swift
// In your view controller
let arrow = PSArrow(height: 25, base: 35, baseCornerRadius: 0, direction: .up)
var design = PSDesign()
design.backGroundColor = UIColor.white
// 'contentView' is the UIView which contains 'Elegant Popover' UILabel
let popoverController = ElegantPopoverController(contentView: contentView,
design: design,
arrow: arrow,
sourceView: view,
sourceRect: CGRect(origin: CGPoint(x: 100, y: 170), size:CGSize.zero))
present(popoverController, animated: true)
```
## Customisations
**Note**: The following customisations are to be done before creating an instance of `ElegantPopoverController`
### Gradient border
```swift
let gradient = CAGradientLayer()
gradient.colors = [UIColor(red: CGFloat(222/255.0),
green: CGFloat(98/255.0),
blue: CGFloat(98/255.0),
alpha: CGFloat(1.0)).cgColor,
UIColor(red: CGFloat(255/255.0),
green: CGFloat(184/255.0),
blue: CGFloat(140/255.0),
alpha: CGFloat(1.0)).cgColor]
gradient.startPoint = CGPoint(x: 0, y: 0)
gradient.endPoint = CGPoint(x: 1, y: 1)
design.borders = [PSBorder(filling: .layer(gradient), width: 12)]
```
### Insets of popover
```swift
design.insets = UIEdgeInsets(top: 20, left: 20, bottom: 20, right: 20)
```
### Corner radius of popover
```swift
design.cornerRadius = 15
```
### Arrow direction
Can be set as `.any` for the popover to figure out appropriate direction on its own
```swift
arrow.direction = .left
```
### Customise arrow shape
```swift
arrow.height = 60
arrow.base = 140
```
### Multiple borders
Multiple borders consisting of either `UIColor` or `CALayer` can be added in any combination
```swift
design.borders = [PSBorder(filling: .layer(gradient), width: 12),
PSBorder(filling: .pureColor(UIColor(red: CGFloat(255/255.0),
green: CGFloat(184/255.0),
blue: CGFloat(140/255.0),
alpha: CGFloat(1.0))), width: 8)]
```
### Solid Arrow
The index of border required to take the shape of a solid arrow and not outline it. Indices go from outermost border starting with `0` to innermost. Default value is `nil` which means all the borders will outline the arrow.
```swift
design.solidArrowBorderIndex = 1
```
### Anchor to UIBarButtonItem
```swift
let popoverController = ElegantPopoverController(contentView: contentView,
design: design,
arrow: arrow,
barButtonItem: barButtonItem)
```
To adjust the arrow position to barButtonItem
```swift
arrow.height = 25
arrow.base = 45
```
## License
This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details