Latest 1.0.0
Homepage https://github.com/shubhankaryash/ScrollCoordinator
License MIT
Platforms ios 8.0
Authors

Version
License
Platform

Example

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

Requirements

Installation

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

pod 'ScrollCoordinator'

Screenshots

Hiding the NavigationBar and ToolBar

ScrollCoordinator

Hiding the NavigationBar and TabBar

ScrollCoordinator

Anchoring the ScrollView

ScrollCoordinator

Usage

For the usage, make your view controller conform to the ScrollCoordinatorManager protocol. The scrollCoordinator needs to be initialised if you are planning to use it. You can have your custom logic of when/if you want/need to initialise this. The implementation here has the bare minimum content within the methods. You could have your custom logic and perform further operations if you want to, but passing these events on to the ScrollCoordinator is a must.

//Implement the ScrollCoordinatorManager in your view controller
class YourViewController: UIViewController, ScrollCoordinatorManager {
//Variable of ScrollCoordinatorManager protocol
var scrollCoordinator: ScrollCoordinator?

/*
Methods of ScrollCoordinatorManager protocol
*/
func getScrollCoordinator() -> ScrollCoordinator? {
    return scrollCoordinator
}

func addBehaviour(view: UIView, behaviour: Behaviour) {
    scrollCoordinator?.addBehaviour(view: view, behaviour: behaviour)
}

func removeBehaviour(view: UIView) {
    scrollCoordinator?.removeBehaviour(view: view)
}

func getBehaviour(for view: UIView) -> Behaviour? {
    return scrollCoordinator?.getBehaviour(for: view)
}

func registerScrollViewToCoordinator(scrollView: UIScrollView) {
    scrollCoordinator?.registerScrollView(scrollView: scrollView)
}

func informCoordinatorVCWillAppear() {
    scrollCoordinator?.vcWillAppear()
}

func informCoordinatorVCWillDisappear() {
    scrollCoordinator?.vcWillDisappear()
}

func informCoordinatorVCDidSublayoutViews() {
    scrollCoordinator?.vcDidSublayoutViews()
}
}

All the scrollviews for which you need the gesture and scroll events need to be registered to the VC implementing the scrollCoordinator manager. This is the method implemented by YourViewController in the above example

registerScrollViewToCoordinator(scrollView: tableView)

Similarly all the behaviours which you want need to be added to the VC implementing the scrollCoordinator manager. This is again implemented by YourViewController. Note that NavBarSnapBehaviour is not supported in nested scroll views.

//Adding NavBarSnapBehaviour
if (navigationController != nil || navigationController?.navigationBar != nil) {
    if let navController = navigationController {
        self.extendedLayoutIncludesOpaqueBars = true //this needs to be done
        addBehaviour(view: navController.navigationBar, behaviour: NavbarSnapBehaviour(snapDirection: .TOP, navController: navController, scrollView: tableView, refreshControl: nil, snapDelegate: nil))
    }
}

//Adding the SnapBehaviour to the bottom bar
if let bottomBar = navigationController?.tabBarController?.tabBar {
    addBehaviour(view: navController.navigationBar, behaviour: NavbarSnapBehaviour(snapDirection: .TOP, navController: navController, scrollView: tableView, refreshControl: nil, snapDelegate: nil))
}

//Adding the AnchorBehaviour
if isAnchorBehaviourEnabled {
    tableView.isScrollEnabled = false //this needs to be disabled to allow the behaviour to scroll the view
    let anchorHeight: CGFloat = 60 //this is the height where the scroll will be anchored
    addBehaviour(view: tableView, behaviour: AnchorBehaviour(scrollView: tableView, anchorHeight: anchorHeight, shouldPreventOriginalScroll: true))
}

For making your own custom behaviours you must conform to the Behaviour protocol.

class PercentageBehaviour: Behaviour {
//This variable determines whether you would receive the scroll events after gesture ends. If you want to listen only to the gestures keep this false. Otherwise you can make this true.
var needsPostGestureInfo: Bool = true

//You will receive all the gestures with the relevant info from the scroll
func handleGestureFromDependantScroll(gestureInfo: PanGestureInformation, scrollTranslationInfo: ScrollTranslationInformation) {
}

//If your behaviour needs to respond to only a single scroll view you can return that as the dependant scrollview. Then you would only receive events from that scrollview
func getDependantScrollView() -> UIScrollView? {
}

//Your behaviour will receive this when a new gesture starts
func gestureDidStart(scrollView: UIScrollView) {
}

//Your behaviour will receive this when the gesture ends
func gestureDidFinish(gestureInfo: PanGestureInformation, scrollView: UIScrollView) {
}

//These are scroll events after the gesture has finished but the scrollview is still scrolling
public func scrollDidTranslateAfterGesture(scrollTranslationInfo: ScrollTranslationInformation) {
}

//These are vc level events
func vcWillAppear() {
}

func vcWillDisappear() {
}

func vcDidSubLayoutViews() {
}

}

Author

shubhankaryash and manishPatwari

License

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

Latest podspec

{
    "name": "ScrollCoordinator",
    "version": "1.0.0",
    "summary": "ScrollCoordinator allows you to attach gestures to scrollviews and perform behaviours on these gestures",
    "description": "ScrollCoordinator is an innovative way to make views behave the way you want them to by listening to gesture and scroll events. This pod comes with the Behaviours to hide the navigation, bottom and tab bar & AnchorBehaviour which makes your outer scrollview scroll upto a certain anchor point when inner nested scrollviews are scrolled",
    "homepage": "https://github.com/shubhankaryash/ScrollCoordinator",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "shubhankaryash": "[email protected]"
    },
    "source": {
        "git": "https://github.com/shubhankaryash/ScrollCoordinator.git",
        "tag": "1.0.0"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source_files": "ScrollCoordinator/Sources/**/*",
    "swift_version": "4.2"
}

Pin It on Pinterest

Share This