Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/marty-suzuki/HoverConversion

HoverConversion realized vertical paging with UITableView. UIViewController will be paged when reaching top or bottom of UITableView contentOffset.
https://github.com/marty-suzuki/HoverConversion

Last synced: about 1 month ago
JSON representation

HoverConversion realized vertical paging with UITableView. UIViewController will be paged when reaching top or bottom of UITableView contentOffset.

Host: GitHub
URL: https://github.com/marty-suzuki/HoverConversion
Owner: marty-suzuki
License: mit
Archived: true
Created: 2016-07-17T15:15:31.000Z (about 8 years ago)
Default Branch: master
Last Pushed: 2016-09-21T01:32:10.000Z (almost 8 years ago)
Last Synced: 2024-07-30T13:32:44.413Z (about 2 months ago)
Language: Swift
Homepage:
Size: 37 MB
Stars: 163
Watchers: 8
Forks: 18
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-ios - HoverConversion - HoverConversion realized vertical paging with UITableView. UIViewController will be paging when reaching top or bottom of UITableView contentOffset. (UI / Table View / Collection View)
awesome-ios-star - HoverConversion - HoverConversion realized vertical paging with UITableView. UIViewController will be paging when reaching top or bottom of UITableView contentOffset. (UI / Table View / Collection View)

README

        # HoverConversion

[![Platform](http://img.shields.io/badge/platform-ios-blue.svg?style=flat

)](https://developer.apple.com/iphone/index.action)

[![Language](http://img.shields.io/badge/language-swift-brightgreen.svg?style=flat

)](https://developer.apple.com/swift)

[![Version](https://img.shields.io/cocoapods/v/HoverConversion.svg?style=flat)](http://cocoapods.org/pods/HoverConversion)

[![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/HoverConversion.svg?style=flat)](http://cocoapods.org/pods/HoverConversion)

[ManiacDev.com](https://maniacdev.com/) referred.  

[https://maniacdev.com/2016/09/hoverconversion-a-swift-ui-component-for-navigating-between-multiple-table-views](https://maniacdev.com/2016/09/hoverconversion-a-swift-ui-component-for-navigating-between-multiple-table-views)

![](./Images/sample1.gif) ![](./Images/sample2.gif)

HoverConversion realized vertical paging with UITableView. UIViewController will be paging when reaching top or bottom of UITableView's contentOffset.

## Featrue

- [x] Vertical paging with UITableView

- [x] Seamless transitioning

- [x] Transitioning with navigationView pan gesture

- [x] Selected cell that related to UIViewController is highlighting

- [x] Support Swift2.3

- [x] Support Swift3

To run the example project, clone the repo, and run `pod install` from the Example directory first.

## Installation

HoverConversion is available through [CocoaPods](http://cocoapods.org). To install

it, simply add the following line to your Podfile:

```ruby

pod "HoverConversion"

```

## Usage

If you install from cocoapods, You have to write `import HoverConversion`.

#### Storyboard or Xib

![](./Images/storyboard.png)

Set custom class of `UINavigationController` to `HCNavigationController`. In addition, set module to `HoverConversion`.

And set `HCRootViewController` as `navigationController`'s first viewController.

#### Code

Set `HCNavigationController` as `self.window.rootViewController`.

And set `HCRootViewController` as `navigationController`'s first viewController.

#### HCPagingViewController

If you want to show vertical contents, please use `HCPagingViewController`.

```swift

let vc = HCPagingViewController(indexPath: indexPath)

vc.dataSource = self

navigationController?.pushViewController(vc, animated: true)

```

#### HCContentViewController

A content included in `HCPagingViewController` is `HCContentViewController`.  

Return `HCContentViewController` (or subclass)  with this delegate method.

```swift

extension ViewController: HCPagingViewControllerDataSource {

    func pagingViewController(viewController: HCPagingViewController, viewControllerFor indexPath: NSIndexPath) -> HCContentViewController? {

        guard 0 <= indexPath.row && indexPath.row < twitterManager.users.count else { return nil }

        let vc = UserTimelineViewController()

        vc.user = twitterManager.users[indexPath.row]

        return vc

    }

}

```

#### HCNextHeaderView

![](./Images/next_header.png)

Return `HCNextHeaderView` (or subclass)  with this delegate method.

```swift

extension ViewController: HCPagingViewControllerDataSource {

    func pagingViewController(viewController: HCPagingViewController, nextHeaderViewFor indexPath: NSIndexPath) -> HCNextHeaderView? {

        guard 0 <= indexPath.row && indexPath.row < twitterManager.users.count else { return nil }

        let view = NextHeaderView()

        view.user = twitterManager.users[indexPath.row]

        return view

    }

}

```

#### Stop transitioning

If you want to load more contents from server and want to stop transitioning, you can use `canPaging` in `HCContentViewController`.

```swift

//Stop transitioning to previous ViewController

canPaging[.prev] = false //Default true

//Stop transitioning to next ViewController

canPaging[.next] = false //Default true

```

## Requirements

- Xcode 7.3 or greater

- iOS 8.0 or greater

- [MisterFusion](https://github.com/marty-suzuki/MisterFusion) - Swift DSL for AutoLayout

## Special Thanks

Those OSS are used in sample project!

- [TouchVisualizer](https://github.com/morizotter/TouchVisualizer) (Created by [@morizotter](https://github.com/morizotter))

- [TwitterKit](https://docs.fabric.io/apple/twitter/overview.html#)

## Author

marty-suzuki, [email protected]

## License

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