Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marioiannotta/pullupcontroller
Pull up controller with multiple sticky points like in iOS Maps
https://github.com/marioiannotta/pullupcontroller
modal-panel sliding-menu swipe user-experience user-interaction
Last synced: 3 days ago
JSON representation
Pull up controller with multiple sticky points like in iOS Maps
- Host: GitHub
- URL: https://github.com/marioiannotta/pullupcontroller
- Owner: MarioIannotta
- License: mit
- Created: 2017-11-04T18:33:35.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-10-08T17:36:18.000Z (2 months ago)
- Last Synced: 2024-10-29T17:55:41.082Z (about 2 months ago)
- Topics: modal-panel, sliding-menu, swipe, user-experience, user-interaction
- Language: Swift
- Homepage:
- Size: 4.9 MB
- Stars: 1,240
- Watchers: 31
- Forks: 142
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PullUpController
Create your own pull up controller with multiple sticky points like in iOS Maps
[](https://developer.apple.com/iphone/index.action)
[](https://developer.apple.com/swift/)
[](https://img.shields.io/cocoapods/v/PullUpController.svg)
[](https://codeclimate.com/github/MarioIannotta/PullUpController/maintainability)
# Features
- Multiple *sticky* points
- Landscape support
- Scroll views friendly
# Setup
1. Add `pod 'PullUpController'` to your Podfile or copy `PullUpController.swift` into your project
2. Make sure the view controller that will be your pull up controller inherits from `PullUpController`
3. Add the controller as child of your main controller using `addPullUpController(<#T##PullUpController#>, initialStickyPointOffset: <#T##CGFloat#>, animated: <#T##Bool#>)`
# Customization
You can customize the controller behavior by overriding the followings properties:
`pullUpControllerPreferredSize: CGSize`
>The desired size of the pull up controller’s view, in screen units.
>The default value is width: `UIScreen.main.bounds.width, height: 400`.
`pullUpControllerPreferredLandscapeFrame: CGRect`
>The desired size of the pull up controller’s view, in screen units when the device is in landscape mode.
>The default value is `(x: 10, y: 10, width: 300, height: UIScreen.main.bounds.height - 20)`.
`pullUpControllerMiddleStickyPoints: [CGFloat]`
>A list of y values, in screen units expressed in the pull up controller coordinate system.
>At the end of the gestures the pull up controller will scroll to the nearest point in the list.
>
>For a complete list of all the sticky points you can use `pullUpControllerAllStickyPoints`
`pullUpControllerBounceOffset: CGFloat`
>A CGFloat value that determines how much the pull up controller's view can bounce outside it's size.
>The default value is 0 and that means the the view cannot expand beyond its size.
It's possible to change the view controller's view position programmatically by using the method
`pullUpControllerMoveToVisiblePoint(_ visiblePoint: CGFloat, animated: Bool, completion: (() -> Void)?)`
>This method will move the pull up controller's view in order to show the provided visible point.
>
>You may use on of `pullUpControllerAllStickyPoints` item to provide a valid visible point.
>- `visiblePoint`: the y value to make visible, in screen units expressed in the pull up controller coordinate system.
>- `animated`: a true value will move the view with an animation.
>- `completion`: the closure to execute after the animation is completed. This block has no return value and takes no parameters. You may specify nil for this parameter.
By overriding the following method it is possible to customize all the animations performed by the controller's view.
` pullUpControllerAnimate(action: Action,
withDuration duration: TimeInterval,
animations: @escaping () -> Void,
completion: ((Bool) -> Void)?)`
>You can consider override this method and customize the animation using the method
>`UIView.animate(withDuration:, delay:, usingSpringWithDamping:, initialSpringVelocity:, options:, animations:, completion:)`
>- `parameter`: The action that is about to be performed (.add, .remove or .move)
>- `duration`: The total duration of the animations, measured in seconds. If you specify a negative value or 0, the changes are made without animating them.
>-`animations`: A block object containing the changes to commit to the views.
>`completion`: A block object to be executed when the animation sequence ends.
It is possible to observe the PullUpController's view state by overriding those methods:
`pullUpControllerWillMove(to point: CGFloat)`
>This method is called before the pull up controller's view move to a sticky point.
`pullUpControllerDidMove(to point: CGFloat)`
>This method is called after the pull up controller's view move to a point.
`pullUpControllerDidDrag(to point: CGFloat)`
>This method is called after the pull up controller's view is dragged to a point.
PullUpController is easy draggable even if your `PullUpController`'s view contains a `UIScrollView`, just attach it to the controller itself with the following method:
`<#T##UIScrollView#>.attach(to: <#T##PullUpController#>)`
>Attach the scroll view to the provided pull up controller in order to move it with the scroll view content.
>- `pullUpController`: the pull up controller to move with the current scroll view content.
# Demo
In this repository you can also find a demo.
# Info
If you like this git you can follow me here or on twitter :) [@MarioIannotta](http://www.twitter.com/marioiannotta)
Cheers from Italy!