Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marty-suzuki/SAParallaxViewControllerSwift
SAParallaxViewControllerSwift realizes parallax scrolling with blur effect. In addition, it realizes seamless opening transition.
https://github.com/marty-suzuki/SAParallaxViewControllerSwift
Last synced: about 1 month ago
JSON representation
SAParallaxViewControllerSwift realizes parallax scrolling with blur effect. In addition, it realizes seamless opening transition.
- Host: GitHub
- URL: https://github.com/marty-suzuki/SAParallaxViewControllerSwift
- Owner: marty-suzuki
- License: mit
- Archived: true
- Created: 2015-01-29T17:02:25.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2016-09-23T14:51:44.000Z (about 8 years ago)
- Last Synced: 2024-11-09T04:02:57.519Z (about 1 month ago)
- Language: Swift
- Homepage:
- Size: 17 MB
- Stars: 260
- Watchers: 10
- Forks: 24
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-cocoa - SAParallaxViewControllerSwift
README
# SAParallaxViewControllerSwift
[](https://developer.apple.com/iphone/index.action)
[](https://developer.apple.com/swift)
[](http://mit-license.org)
[](http://cocoadocs.org/docsets/MSAlertController)
 
SAParallaxViewControllerSwift realizes parallax scrolling with blur effect. In addition, it realizes seamless opening transition.
## Features
- [x] Parallax scrolling
- [x] Parallax scrolling with blur accessory view
- [x] Seamlees opening transition
- [x] Support Swift2.3
- [x] Support Swift3
## Installation
#### CocoaPods
SAParallaxViewControllerSwift is available through [CocoaPods](http://cocoapods.org). If you have cocoapods 0.36 beta or greater, you can install
it, simply add the following line to your Podfile:
pod "SAParallaxViewControllerSwift"
#### Manually
Add the [SAParallaxViewControllerSwift](./SAParallaxViewControllerSwift) directory to your project.
## Usage
If you install from cocoapods, You have to white `import SAParallaxViewControllerSwift`.
Extend `SAParallaxViewController` like this.
```swift
class ViewController: SAParallaxViewController {
override init() {
super.init()
}
override init(nibName nibNameOrNil: String?, bundle nibBundleOrNil: NSBundle?) {
super.init(nibName: nibNameOrNil, bundle: nibBundleOrNil)
}
required init(coder aDecoder: NSCoder) {
super.init(coder: aDecoder)
}
override func viewDidLoad() {
super.viewDidLoad()
}
}
```
If you want to use `UICollectionViewDataSource`, implement extension like this. You can set image with `cell.setImage()`. You can add some UIView member classes to `cell.containerView.accessoryView`.
```swift
extension ViewController: UICollectionViewDataSource {
override func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {
let cell = super.collectionView(collectionView, cellForItemAt: indexPath) as! SAParallaxViewCell
let index = indexPath.row % 6
let imageName = String(format: "image%d", index + 1)
if let image = UIImage(named: imageName) {
cell.setImage(image)
}
let title = ["Girl with Room", "Beautiful sky", "Music Festival", "Fashion show", "Beautiful beach", "Pizza and beer"]
let label = UILabel(frame: cell.containerView.accessoryView.bounds)
label.textAlignment = .Center
label.text = title[index]
label.textColor = .whiteColor()
label.font = .systemFontOfSize(30)
cell.containerView.accessoryView.addSubview(label)
return cell
}
}
```
If you want to use `UICollectionViewDelegate`, implement extension like this.
You must copy `cell.containerView` to `viewController.trantisionContainerView` because to use opening transition. When you copy them, use `containerView.setViews(cells: cells, view: view)`. Set `viewController.transitioningDelegate` as self, finally call `self.presentViewController()`.
```swift
extension ViewController: UICollectionViewDelegate {
override func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
super.collectionView(collectionView, didSelectItemAt: indexPath)
guard let cells = collectionView.visibleCells as? [SAParallaxViewCell] else { return }
let containerView = SATransitionContainerView(frame: view.bounds)
containerView.setViews(cells, view: view)
let viewController = DetailViewController()
viewController.transitioningDelegate = self
viewController.trantisionContainerView = containerView
present(viewController, animated: true, completion: nil)
}
}
```
Extend `SADetailViewController` like this.
`SADetailViewController` is detail view controller for parallax cell.
```swift
class DetailViewController: SADetailViewController {
override init() {
super.init()
}
override init(nibName nibNameOrNil: String?, bundle nibBundleOrNil: NSBundle?) {
super.init(nibName: nibNameOrNil, bundle: nibBundleOrNil)
}
required init(coder aDecoder: NSCoder) {
super.init(coder: aDecoder)
}
override func viewDidLoad() {
super.viewDidLoad()
}
}
```
## Customize
You can change parallax start position with function of `cell.containerView`.
```swift
func setParallaxStartPosition(#y: CGFloat)
```
You can change height of `cell.containerView.accessoryView`.
```swift
func setAccessoryViewHeight(height: CGFloat)
```
You can change blur size of `cell.containerView.accessoryView`.
```swift
func setBlurSize(size: CGFloat)
```
You can change blur color of `cell.containerView.accessoryView`.
```swift
func setBlurColor(color: UIColor)
```
You can change blur color alpha of `cell.containerView.accessoryView`.
```swift
func setBlurColorAlpha(alpha: CGFloat)
```
## Requirements
- Xcode 8.0-beta or greater
- iOS 8.0 or greater
- ARC
- [SABlurImageView](https://github.com/szk-atmosphere/SABlurImageView)
- [MisterFusion](https://github.com/szk-atmosphere/MisterFusion)
## Author
Taiki Suzuki, [email protected]
## License
SAParallaxViewControllerSwift is available under the MIT license. See the LICENSE file for more info.