jonathantribouharet / jt3dscrollview Goto Github PK

View Code? Open in Web Editor NEW

491.0 19.0 72.0 497 KB

ScrollView with custom effects during the scroll for iOS

License: MIT License

Objective-C 4.64% Ruby 4.16% Shell 45.89% Swift 45.31%

ios scrollview uiscrollview carousel swift

jt3dscrollview's Introduction

JT3DScrollView

JT3DScrollView is a UIScrollView with custom effects during the scroll.

Installation

With CocoaPods, add this line to your Podfile.

pod 'JT3DScrollView', '~> 2.0'

Screenshots

Usage

You can use it like a classic UIScrollView, the isPagingEnabled is set to true by default and clipsToBounds is set to false.

import UIKit
import JT3DScrollView

class ViewController: UIViewController {

    @IBOutlet weak var scrollView: JT3DScrollView?

    override func viewDidLoad() {
        super.viewDidLoad()
        scrollView?.effect = .cards
    }
}

You can disable the effect and act like a classic UIScrollView by setting effect to .none.

Effects are just preset for some properties used for the animations, you can adjust all effects with:

angleRatio
rotationX
rotationY
rotationZ
translateX
translateY

All this properties are relative to the position X of the subview.

Requirements

iOS 8 or higher
Swift 3.0

Author

Jonathan Tribouharet (@johntribouharet)

License

JT3DScrollView is released under the MIT license. See the LICENSE file for more info.

jt3dscrollview's People

Contributors

Stargazers

Watchers

jt3dscrollview's Issues

First item on Scrollview doesn't appear correctly on screen with Navigation Controller

Hello,

Using the example provided on the .zip I added a Navigation View Controller and the behavior of the first Item on the array does not center correctly, also the rest of them works fine. I've tried changing the top constraints to the navigation controller instead of the TOP of the view. See video

https://drive.google.com/file/d/0B4Q3UfIP0FCUZUI5Y3BDWEFlQ0U/view?usp=sharing

Thanks

Less "sticky" scrolling

This is a beautiful, succinct solution. I was wondering how to get the scroll to spin more freely, that is to go through more cards before stopping. I got the perfect answer here :

https://stackoverflow.com/questions/11561992/sensitivity-scroll-speed-of-uiscrollview-with-paging

In brief, turn off the isPagingEnabled flag, and implement the delegate method scrollViewWillEndDragging. (The stackoverflow answer sets the scroll deceleration to fast, but it should be normal.)

Do you have a swift implementation version?

Hey Jonathan,

very cool 3d slide, do you have the swift version of this?>

Cheers,
adam

Paging

I added this as a horizontal scroll view to an app that only uses landscape orientation. I can't stop it from allowing vertical scrolling. It also does not page the the correct x coordinate. Only the first subview is in the correct position. I'm developing on iOS 9.3. Any help would be appreciated.

Drag from outside the JT3DScrollView frame

The first thing I wanted to do with this View was drag on one of the images that was outside the View's frame. (The JT3DScrollView has clipsToBounds set to false, so the previous and next — and maybe others — show outside the View proper.)

The way to do this is to embed the JT3DScrollView in another view. Make the enclosing view a custom subclass of UIView and add this and only this method:

 override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
    if self.point(inside: point, with: nil) {
        return subviews.first
    } else {
        return super.hitTest(point, with: event)
    }
}

Now drags in the enclosing view will be passed to the enclosed JT3DScrollView. Have fun! And thanks JT for such a clean implementation.