Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

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

SAHistoryNavigationViewController realizes iOS task manager like UI in UINavigationContoller. Support 3D Touch!
https://github.com/marty-suzuki/sahistorynavigationviewcontroller

animation support-3d-touch swift

Last synced: 4 days ago
JSON representation

SAHistoryNavigationViewController realizes iOS task manager like UI in UINavigationContoller. Support 3D Touch!

Host: GitHub
URL: https://github.com/marty-suzuki/sahistorynavigationviewcontroller
Owner: marty-suzuki
License: mit
Created: 2015-03-26T05:45:13.000Z (almost 10 years ago)
Default Branch: master
Last Pushed: 2017-10-31T16:46:23.000Z (about 7 years ago)
Last Synced: 2024-12-14T21:04:45.215Z (11 days ago)
Topics: animation, support-3d-touch, swift
Language: Swift
Homepage:
Size: 15.8 MB
Stars: 1,572
Watchers: 35
Forks: 91
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # SAHistoryNavigationViewController

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

[![License](https://img.shields.io/cocoapods/l/SAHistoryNavigationViewController.svg?style=flat)](http://cocoapods.org/pods/SAHistoryNavigationViewController)

**Support 3D Touch for iOS9!!**

![](./SampleImage/touch.gif)

![](./SampleImage/3dtouch.gif)

![](./SampleImage/sample.gif)

SAHistoryNavigationViewController realizes iOS task manager like UI in UINavigationContoller.

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

[https://maniacdev.com/2015/03/open-source-component-enhancing-the-back-button-with-view-history-navigation](https://maniacdev.com/2015/03/open-source-component-enhancing-the-back-button-with-view-history-navigation)

## Features

- [x] iOS task manager like UI

- [x] Launch Navigation History with Long tap action of Back Bar Button

- [x] Support Swift2.0

- [x] Support 3D Touch (If device is not supported 3D Touch, automatically replacing to long tap gesture.)

- [x] Support Swift2.3

- [x] Sipport Swift3

## Installation

#### CocoaPods

SAHistoryNavigationViewController is available through [CocoaPods](http://cocoapods.org). If you have cocoapods 0.38.0 or greater, you can install

it, simply add the following line to your Podfile:

    pod "SAHistoryNavigationViewController"

#### Manually

Add the [SAHistoryNavigationViewController](./SAHistoryNavigationViewController) directory to your project.

## Usage

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

#### Storyboard or Xib

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

Set custom class of UINavigationController to SAHistoryNavigationViewController.

In addition, set module to SAHistoryNavigationViewController.

#### Code

You can use SAHistoryNavigationViewController as `self.sah.navigationController` in any ViewController, bacause implemented `extension SAHistoryExtension` as below codes.

```swift

public protocol SAHistoryCompatible {

    associatedtype CompatibleType

    var sah: CompatibleType { get }

}

public extension SAHistoryCompatible {

    public var sah: SAHistoryExtension {

        return SAHistoryExtension(self)

    }

}

public final class SAHistoryExtension {

    public let base: Base

    public init(_ base: Base) {

        self.base = base

    }

}

extension UIViewController: SAHistoryCompatible {}

extension SAHistoryExtension where Base: UIViewController {

    public var navigationController: SAHistoryNavigationViewController? {

        return base.navigationController as? SAHistoryNavigationViewController

    }

}

```

And you have to initialize like this.

```swift

let ViewController = UIViewController()

let navigationController = SAHistoryNavigationViewController()

navigationController.setViewControllers([ViewController], animated: true)

presentViewController(navigationController, animated: true, completion: nil)

```

If you want to launch Navigation History without long tap action, use this code.

```swift

//In any UIViewController

self.sah.navigationController?.showHistory()

```

## Customize

If you want to customize background of Navigation History, you can use those methods.

```swift

//In any UIViewController

self.sah.navigationController?.contentView

self.sah.navigationController?.historyBackgroundColor

```

This is delegate methods.

```swift

@objc public protocol SAHistoryNavigationViewControllerDelegate: NSObjectProtocol {

    optional func historyControllerDidShowHistory(controller: SAHistoryNavigationViewController, viewController: UIViewController)

}

```

## Requirements

- Xcode 8.0 or greater

- iOS8.0 or greater

- [MisterFusion](https://github.com/szk-atmosphere/MisterFusion)

## Author

Taiki Suzuki, [email protected]

## License

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