Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/ngochiencse/HPParallaxHeader

Simple parallax header for UIScrollView.
https://github.com/ngochiencse/HPParallaxHeader

Last synced: about 2 months ago
JSON representation

Simple parallax header for UIScrollView.

Lists

README 

        
# HPParallaxHeader



[![Travis (.com)](https://img.shields.io/travis/com/ngochiencse/HPParallaxHeader)](https://www.travis-ci.com/github/ngochiencse/HPParallaxHeader)

[![Version](https://img.shields.io/cocoapods/v/HPParallaxHeader)](http://cocoapods.org/pods/HPParallaxHeader)

[![Swift 5.4](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fngochiencse%2FHPParallaxHeader%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/ngochiencse/HPParallaxHeader)

[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

[![License](https://img.shields.io/cocoapods/l/HPParallaxHeader)](http://cocoapods.org/pods/HPParallaxHeader)

[![Cocoapods platforms](https://img.shields.io/cocoapods/p/HPParallaxHeader)](http://cocoapods.org/pods/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          |

|---------------------------------|-------------------------------------------|

|![Demo](Example/demo1.gif)|![Demo](Example/demo2.gif)|



## Usage



If you want to try it, simply run:



```

pod try HPParallaxHeader

```



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



```swift

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](https://swift.org/package-manager/)  directly within Xcode or add it to the `dependencies` value of your `Package.swift`.



```swift

dependencies: [

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

]

```



### CocoaPods



HPParallaxHeader is available through [CocoaPods](http://cocoapods.org). To install it, simply add the following line to your Podfile:



```ruby

pod "HPParallaxHeader"

```



## Documentation



Documentation is available through [GitHub](https://ngochiencse.github.io/HPParallaxHeader/documentation/hpparallaxheader).



## Author



[Hien Pham](https://github.com/ngochiencse)



![Twitter URL](https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Ftwitter.com%2Fngochien91)



## License



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