ngochiencse / hpparallaxheader

Simple parallax header for UIScrollView.

HPParallaxHeader

HPParallaxHeader is a Swift conversion from https://github.com/maxep/MXParallaxHeader.

HPParallaxHeader is a simple header class for UIScrollView.

In addition, HPScrollView is a UIScrollView subclass with the ability to hook the vertical scroll from its subviews, this can be used to add a parallax header to complex view hierachy. Moreover, HPScrollViewController allows you to add a HPParallaxHeader to any kind of UIViewController.

UIScrollView	HPScrollViewController

Usage

If you want to try it, simply run:

pod try HPParallaxHeader

• Adding a parallax header to a UIScrollView is straightforward, e.g:

let headerView = UIImageView()
headerView.image = UIImage(named: "success-baby")
headerView.contentMode = .scaleAspectFit

let scrollView = UIScrollView()
scrollView.parallaxHeader.view = headerView
scrollView.parallaxHeader.height = 150
scrollView.parallaxHeader.mode = .fill
scrollView.parallaxHeader.minimumHeight = 20

• The HPScrollViewController is a container with a child view controller that can be added programmatically or using the custom segue HPScrollViewControllerSegue.

Installation

Swift Package Manager

You can use Swift Package Manager directly within Xcode or add it to the dependencies value of your Package.swift.

dependencies: [
    .package(url: "https://github.com/ngochiencse/HPParallaxHeader", .upToNextMajor(from: "1.1.8"))
]

CocoaPods

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

pod "HPParallaxHeader"

Documentation

Documentation is available through GitHub.

Author

Hien Pham

License

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

hpparallaxheader's Issues

[Feature] Add scrollViewDidScroll method

Could you append scrollViewDidScroll for HPScrollViewDelegate?

[Request] Header background color option

final class MyContainerViewController: HPScrollViewController {    
    override var preferredStatusBarStyle : UIStatusBarStyle {
        return UIStatusBarStyle.lightContent
    }


    override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)

        if #available(iOS 13.0, *) {
            let appearance = UINavigationBarAppearance()
            appearance.configureWithTransparentBackground()
            appearance.titleTextAttributes = [.foregroundColor: UIColor.white]
            appearance.backgroundColor = UIColor(red: 0.0/255.0, green: 123.0/255.0, blue: 187.0/255.0, alpha: 1.0)
         
            navigationController?.navigationBar.scrollEdgeAppearance = appearance
            navigationController?.navigationBar.standardAppearance = appearance
        }
    }

it can't mack white header under clock.
Or I want the option for it.

[Feature] I want to access scrollView or contentOffset

It can't access scrollView

extension HeaderViewController: HPParallaxHeaderDelegate {
    func parallaxHeaderDidScroll(_ parallaxHeader: HPParallaxHeader) {
        // can't access scrollView
        if let scrollView = parallaxHeader.scrollView {
            trackingOffset(scrollView)
        }
}

'scrollView' is inaccessible due to 'internal' protection level

[Request]Migration Documents from MXParallaxHeader

I think there are many MXParallaxHeader users.
I hope migration from Objective-C to Swift version.

HPScrollViewController viewDidLoad override

HPScrollViewController's viewDidLoad() can't override in inherited class

Swift Package Manger Issue

When installing it shows an error:

because HPParallaxHeader >=1.1.5 contains incompatible tools version and root depends on HPParallaxHeader 1.1.7..<2.0.0, version solving failed

Any tip to resolve this?

[BUG] delegate parallaxHeaderDidScroll is called before scrolling

parallaxHeaderDidScroll method return strange values even before my scrolling.(when initialized?)

func parallaxHeaderDidScroll(_ parallaxHeader: HPParallaxHeader) {
    var progress = parallaxHeader.progress
    print(progress)
}

In the first loaded view controller.

it logged 1, 0 before scrolling.

ParallaxHeaderMode(bottom) Layout Issue

Hi,

Thanks for changing MXParallaxHeader to Swift.

I found a problem with ParallaxHeaderMode (bottom).

• HPParallaxHeader

• MXParallaxHeader

HPParallaxHeader is a topAnchor, but MXParallaxHeader is a bottomAnchor.

I hope this will be a quick fix.