https://github.com/tungvoduc/dtcontainercontroller

A Swift container view controller to handle transitioning to a different child view controller.
https://github.com/tungvoduc/dtcontainercontroller

cocoapods container-viewcontroller swift swift4 swift5 viewcontroller xcode

Last synced: 25 days ago
JSON representation

A Swift container view controller to handle transitioning to a different child view controller.

• Host: GitHub
• URL: https://github.com/tungvoduc/dtcontainercontroller
• Owner: tungvoduc
• License: mit
• Created: 2017-09-22T21:04:08.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2019-04-30T21:45:01.000Z (over 5 years ago)
• Last Synced: 2024-09-16T23:18:42.062Z (about 2 months ago)
• Topics: cocoapods, container-viewcontroller, swift, swift4, swift5, viewcontroller, xcode
• Language: Swift
• Homepage:
• Size: 245 KB
• Stars: 20
• Watchers: 2
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# DTContainerController

[![CI Status](http://img.shields.io/travis/tungvoduc/DTContainerController.svg?style=flat)](https://travis-ci.org/tungvoduc/DTContainerController)

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

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

[![Platform](https://img.shields.io/cocoapods/p/DTContainerController.svg?style=flat)](http://cocoapods.org/pods/DTContainerController)

DTContainerController is a view controller container written in Swift.

## Why DTContainerController?

There are cases where you want to present a new view controller and destroy the current view controller. The most applicable cases are when user goes through onboarding phase and logs into the app or when user logs out from the app to log-in view. In these cases, the new view controller are presented and there is no reasons to keep old view controller alive,  this cannot be done by using present(_:animated:completion:) since the presenting view controller still exists after presentation. This is why DTContainerController becomes handy.

DTContainerController should usually be used as the root view controller of the application window.

## Screenshot

![Screenshot](giphy.gif)

## Usage

DTContainerController has at most one child view controller. In order to set the child view controller or replace the current child view controller with animation, you can use:

```swift

// Set or replace current view controller without animation

containerController.show(childViewController, animated: false, completion: nil)

// Present a new child view controller and destroy current child view controller with transition

containerController.show(childViewController, animated: true, completion: nil)

```

Accessing container controller ancestor is similar to navigationController or tabbarController:

```swift

// Access parent container controller and present a new view controller

self.containerViewController?.show(childViewController, animated: true, completion: nil)

```

## Example

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

## Requirements

#### iOS 8.3+

## Installation

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

it, simply add the following line to your Podfile:

```ruby

pod 'DTContainerController'

```

## Author

Tung Vo, [email protected]

## License

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