README.md

Overview

RamblerSegues is a collection of custom UIStoryboardSegue subclasses useful in different everyday situations.

Key features

• EmbedSegue - present child UIViewControllers as easy as it should be.
• CrossStoryboardSegue - if you're afraid of linked UIStoryboards - this segue is your perfect choice.

Usage

EmbedSegue

1. Add a UIView on your parent UIViewController - this view will suit as a container for a child module. Connect it to IBOutlet with name embedSegueContainer.
2. Add a segue with class RamblerEmbedSegue from parent UIViewController to child UIViewController. Set its identifier to EmbedSegueExample.

3. Implement a method - (UIView*)viewForEmbedIdentifier:(NSString*)embedIdentifier in parent UIViewController and return embedSegueContainer in it:

- (UIView*)viewForEmbedIdentifier:(NSString*)embedIdentifier {
  if ([embedIdentifier isEqualToString:@"EmbedSegueExample"]) {
      return self.embedSegueContainer;
  }
  return nil;
}

4. Enjoy - now you can manage child view controller transitions just like any other - even from Router using ViperMcFlurry.

CrossStoryboardSegue

1. Add a new empty UIViewController on the first storyboard. Set its class to RamblerPlaceholderViewController and restoration identifier to SecondViewController@AnotherStoryboard.

2. Add a segue with class CrossStoryboardSegueExample and identifier CrossStoryboardSegueExample from parent UIViewController to this placeholder. 3. Add your target view controller to second storyboard - AnotherStoryboard. Set its Storyboard ID to SecondViewController. 4. Enjoy once again - you can use this segue just as usual one, but instead it will open UIViewController from another storyboard:

[self performSegueWithIdentifier:@"CrossStoryboardSegueExample" sender:self];

You can test both segues in the example project - clone the repo, and run pod install from the Example directory first.

Installation

RamblerSegues is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "RamblerSegues"

License

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

Author

Andrey Zarembo-Godzyatskiy, [email protected]