https://github.com/hirohisa/PageController
Infinite paging controller, scrolling through contents and title bar scrolls with a delay
https://github.com/hirohisa/PageController
carthage cocoapods delay pagecontroller scrolling scrollview-component
Last synced: 3 months ago
JSON representation
Infinite paging controller, scrolling through contents and title bar scrolls with a delay
- Host: GitHub
- URL: https://github.com/hirohisa/PageController
- Owner: hirohisa
- License: mit
- Created: 2015-07-05T15:51:03.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2022-06-13T15:14:34.000Z (over 3 years ago)
- Last Synced: 2024-11-17T17:56:16.602Z (12 months ago)
- Topics: carthage, cocoapods, delay, pagecontroller, scrolling, scrollview-component
- Language: Swift
- Homepage:
- Size: 905 KB
- Stars: 407
- Watchers: 12
- Forks: 43
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-swift - PageController - Infinite paging controller. (Libs / UI)
- awesome-swift - PageController - Infinite paging controller. (Libs / UI)
- awesome-ios-star - PageController - Infinite paging controller, scrolling through contents and title bar scrolls with a delay. (UI / Font)
- fucking-awesome-swift - PageController - Infinite paging controller. (Libs / UI)
- awesome-swift-cn - PageController - Infinite paging controller. (Libs / UI)
- awesome-ios - PageController - Infinite paging controller, scrolling through contents and title bar scrolls with a delay. (UI / Font)
- awesome-swift - PageController - Infinite paging controller, scrolling through contents and title bar scrolls with a delay ` 📝 9 months ago` (UI [🔝](#readme))
README
PageController
==================
[](https://travis-ci.org/hirohisa/PageController)
[](https://cocoapods.org/pods/PageController)
[](https://github.com/Carthage/Carthage)
[](https://github.com/hirohisa/ImageLoaderSwift/blob/master/LICENSE)
PageController is infinite paging controller, scrolling through contents and title bar scrolls with a delay. Then it provide user interaction to smoothly and effortlessly moving. It is for iOS written in Swift.
Requirements
----------
PageController | Xcode | Swift
-------------- | ----- | -----
0.7.x + | 9.4 | 4.1
0.6.x | 9.2 | 4.0
0.5.x | 8.2 | 3.0
0.4.x | 8.0 | 2.2
0.3.x | 7.0+ | 2.0
0.2.0 | 6.4 | 1.2
Features
----------
- [x] To inherit from [DCScrollView](https://github.com/hirohisa/DCScrollView)
- [x] Use `UIViewController`, not `UIView` like `UITabBarController`
- [x] Support AutoLayout about MenuCell
- [x] Handling to change current view controller with Delegate.
- [x] Scrolling smoothly and effortlessly
- [x] Keep to smoothly in scrolling contents
Installation
----------
### CocoaPods
```ruby
pod 'PageController'
```
### Carthage
To integrate PageController into your Xcode project using Carthage, specify it in your `Cartfile`:
```
github "hirohisa/PageController" ~> 0.7.1
```
Usage
----------
**viewControllers**
Type is [UIViewController], and element must have title.
```swift
import PageController
class CustomViewController: PageController {
override func viewDidLoad() {
super.viewDidLoad()
viewControllers = createViewControllers()
}
func createViewControllers() -> [UIViewController] {
let names = [
"favorites",
"recents",
"contacts",
"history",
"more",
]
return names.map { name -> UIViewController in
let viewController = ContentViewController()
viewController.title = name
return viewController
}
}
}
```
**MenuBar**
Enable to change backgroundColor, frame.
If you change MenuBarCell.height, then override `frameForMenuBar` and set height.
```swift
/// backgroudColor
menuBar.backgroundColor = UIColor.whiteColor().colorWithAlphaComponent(0.9)
/// skip to auto-select after scrolling
menuBar.isAutoSelectDidEndUserInteractionEnabled = false
/// frame, override this function
override var frameForMenuBar: CGRect {
let frame = super.frameForMenuBar
return CGRect(x: frame.minX, y: frame.minY, width: frame.width, height: 60)
}
```
**MenuBarCell**
Enable to use Custom Cell supported `MenuBarCellable` protocol:
```swift
public protocol MenuBarCellable {
var index: Int { get set }
func setTitle(_ title: String)
func setHighlighted(_ highlighted: Bool)
func prepareForReuse()
}
public func register(_ cellClass: MenuBarCellable) {
guard let cellClass = cellClass as? UIView.Type else { fatalError() }
self.cellClass = cellClass
}
public func register(_ nib: UINib) {
self.nib = nib
}
```
**MenuBarCellable**
```swift
public protocol MenuBarCellable {
// it's used by PageController
var index: Int { get set }
// it is used to set to Label.text, caused by deprecating MenuCell over 0.7
func setTitle(_ title: String)
// it's instead of `updateData` over 0.7,
func setHighlighted(_ highlighted: Bool)
// Called by the menu bar on creating the instance.
func prepareForUse()
}
```
## License
PageController is available under the MIT license.