Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andriadze/ctslidinguppanel
iOS CTSlidingUpPanel - Transforms any view to sliding panel
https://github.com/andriadze/ctslidinguppanel
ios slidinglayout slidinguppanel swift swift-3
Last synced: 15 days ago
JSON representation
iOS CTSlidingUpPanel - Transforms any view to sliding panel
- Host: GitHub
- URL: https://github.com/andriadze/ctslidinguppanel
- Owner: andriadze
- License: mit
- Created: 2017-06-29T12:08:56.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-07-19T09:51:14.000Z (over 5 years ago)
- Last Synced: 2024-03-15T14:20:51.850Z (8 months ago)
- Topics: ios, slidinglayout, slidinguppanel, swift, swift-3
- Language: Swift
- Homepage:
- Size: 572 KB
- Stars: 124
- Watchers: 8
- Forks: 32
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# iOS-CTSlidingUpPanel
[](http://cocoapods.org/pods/CTSlidingUpPanel)
[](http://cocoapods.org/pods/CTSlidingUpPanel)
[](http://cocoapods.org/pods/CTSlidingUpPanel)
Transforms any view to sliding panel
Panel supports Anchor points, TabBarController and NavigationController, also it has basic TableView support.
# Cocoapods
### Swift 4.2
Add following to your Podfile:
```
pod "CTSlidingUpPanel"
```
### Swift 4.0
```
pod "CTSlidingUpPanel", '~> 1.0.4'
```
### How to Import
**Make sure to build and clean the project:**
```swift
import CTSlidingUpPanel
```
### Objective C - support
Starting from `Version 1.2.0` you can use this library in Objective C projects.
To do this first add: `use_frameworks!` - in your podfile. Run pod install and build the project.
To import in Objective C class use:
```objc
@import CTSlidingUpPanel;
```
Example of constructor in Objective C:
```objc
[[CTBottomSlideController alloc] initWithParent:self.view bottomView:_testView tabController:nil navController:nil visibleHeight:20];
```
# Manual Setup instructions
1. Download this repository
2. Copy files from lib folder to your project.
3. Should be done.
# How to use
You can view example project to better understand how stuff works.
But here are basic steps with Storyboard:
1. Drag any View(Or Container View) to the parent view.
**DO NOT give this view any constraints**.
2. Create outlet of the view you wish to use as bottom panel
After that in your ViewController:
```swift
@IBOutlet weak var bottomView: UIView!
var bottomController:CTBottomSlideController?;
override func viewDidLoad() {
super.viewDidLoad()
//You can provide nil to tabController and navigationController
bottomController = CTBottomSlideController(parent: view, bottomView: bottomView,
tabController: self.tabBarController?,
navController: self.navigationController, visibleHeight: 64)
//0 is bottom and 1 is top. 0.5 would be center
bottomController?.setAnchorPoint(anchor: 0.7)
}
///Added in Version: 1.1.0 - To support Screen orientation changes!
override func viewWillTransition(to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator) {
super.viewWillTransition(to: size, with: coordinator)
bottomController?.viewWillTransition(to: size, with: coordinator)
}
```
And done, view you provided to bottomView should slide up and down.
You can do same without Storyboards. Add new subview to your parent and then provide that subview to CTBottomSlideController.
It is recomended that you don't give that subview any constraints.
## In case you want custom width/position of sliding panel
In this case you should set: Top, Height and other constraints that you want(**But don't set the bottom one**) to the SlidingView and then use this initializer:
```swift
bottomController = CTBottomSlideController(topConstraint: slidingPanelTopConstraint,
heightConstraint: slidingPanelHeightConstraint,
parent: view,
bottomView: bottomView,
tabController: self.tabBarController!,
navController: self.navigationController,
visibleHeight: 64)
```
**It is IMPORTANT that you don't set the bottom constraint of the sliding view** or the sliding view will start resizing and that
may affect performace.
### iPhone X Safe Area support
1. Take a Sliding View(View you provided to CTBottomSlideController) and **wrap it in a generic UIView**.
2. **Enable Clip to Bounds on the wrapper View**
3. Set any constraints you want to that **wrapper view**, place it anywhere resize it as much as you want.
4. After that in CTBottomSlideController initializer provide that wrapper **as a parrent view** instead of root view.
```swift
//This is a wrapper view
@IBOutlet weak var parentView: UIView!
//In viewDidLoad() or something
parentView.clipsToBounds = true;
bottomController = CTBottomSlideController(parent: parentView/*instead of view*/, bottomView: bottomView,
tabController: self.tabBarController!,
navController: self.navigationController, visibleHeight: 64)
```
## Getting events from Sliding Controller
There are 2 ways of doing this. One is with delegation and other is by using closures.
### Delegation:
1. Add this to your ViewController
```swift
class ViewController: UIViewController, CTBottomSlideDelegate
{...}
```
2. Set viewcontroller as a delegate
```swift
bottomController?.delegate = self;
```
3. Implement following methods
```swift
func didPanelCollapse();
func didPanelExpand();
func didPanelAnchor();
func didPanelMove(panelOffset: CGFloat);
```
### Closures:
```swift
bottomController?.onPanelExpanded = {
print("Panel Expanded in closure")
}
bottomController?.onPanelCollapsed = {
print("Panel Collapsed in closure")
}
bottomController?.onPanelAnchored = {
print("On Panel anchored")
}
bottomController?.onPanelMoved = { offset in
print("Panel moved in closure " + offset.description)
}
```
### Methods and Other stuff
Use this if you want sliding panel to slide up or down depending on ScrollViews offset:
```swift
func set(collectionView: UICollectionView)
func set(scrollView: UIScrollView)
func set(table:UITableView)
```
You can use ```set(scrollView: UIScrollView)``` for any type of scrollview. In reality other methods just call this one
#### Use this if you want to specify how far up sliding panel should go
```swift
func setExpandedTopMargin(pixels: CGFloat)
```
#### Use these to programatically change panels state
```swift
func expandPanel();
func anchorPanel();
func closePanel();
func hidePanel();
func setSlideEnabled(bool) // Enable or disable sliding
```
Use this to check panels state
```swift
bottomController?.currentState
```
State can be
```swift
.collapsed
.expanded
.anchored
.hidden
```