https://github.com/MarcoSero/MSMatrixController

A component to organize your view controllers in a gesture-based 2D matrix.
https://github.com/MarcoSero/MSMatrixController

Last synced: 3 months ago
JSON representation

A component to organize your view controllers in a gesture-based 2D matrix.

• Host: GitHub
• URL: https://github.com/MarcoSero/MSMatrixController
• Owner: MarcoSero
• License: mit
• Created: 2013-03-31T18:10:34.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2013-06-02T09:27:54.000Z (over 11 years ago)
• Last Synced: 2024-10-16T09:02:48.468Z (3 months ago)
• Language: Objective-C
• Homepage: http://www.marcosero.com
• Size: 646 KB
• Stars: 133
• Watchers: 13
• Forks: 15
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - MSMatrixController - A component to organize your view controllers in a gesture-based 2D matrix. (etc)
• awesome - MSMatrixController - A component to organize your view controllers in a gesture-based 2D matrix. (etc)

README

        
# MSMatrixController

A component to organize your view controllers in a gesture-based 2D matrix.

![image](MSMatrixControllerDemo/animated_matrix.gif)

## Get it ready

The best way to install it inside your project is with [CocoaPods](http://cocoapods.org/): simply add

    pod 'MSMatrixController'

inside your Podfile.   

If for some mysterious reason you are not using CocoaPods, copy the folder `MSMatrixController` inside your Xcode project.

Then, import `MSMatrixController.h` inside your prefix or application delegate. 

## How it works

Organize your view controllers inside a Matrix, specifying for each of them its row and column. Then add them inside an instance of MSMatrixController.

![image](MSMatrixControllerDemo/matrix.jpg)

    - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

    {

      UIStoryboard *currentStoryboard = [UIStoryboard storyboardWithName:@"iPhone" bundle:nil];

      UIViewController *initialViewController = self.window.rootViewController;

      MSMatrixMasterViewController *matrixMasterViewController = [[MSMatrixMasterViewController alloc] initWithFrame:initialViewController.view.frame];

      UIViewController *position00ViewController = [currentStoryboard instantiateViewControllerWithIdentifier:@"position00"];

      position00ViewController.row = 0;

      position00ViewController.col = 0;

      UIViewController *position01ViewController = [currentStoryboard instantiateViewControllerWithIdentifier:@"position01"];

      position01ViewController.row = 0;

      position01ViewController.col = 1;

      

      UIViewController *position11ViewController = . . . . 

      NSArray *controllers = @[position00ViewController, position01ViewController, position11ViewController, position12ViewController,

    position21ViewController, position22ViewController, position23ViewController, position24ViewController, position14ViewController];

    

      [matrixMasterViewController setControllers:controllers];

      self.window.rootViewController = matrixMasterViewController;

      [self.window makeKeyAndVisible];

      return YES;

    }

## Features  

    

For each controller, you can access its neighborhood:

    controller.leftViewController

    controller.rightViewController

    controller.topViewController

    controller.bottomViewController

    

and the matrix master controller:

    controller.matrixViewController

    

The default way to navigate the matrix of controllers is with swipe gestures, but you can move through them programmatically as well.

    - (void)moveLeftAnimated:(BOOL)animated;

    - (void)moveRightAnimated:(BOOL)animated;

    - (void)moveUpAnimated:(BOOL)animated;

    - (void)moveDownAnimated:(BOOL)animated;

    - (void)moveLeftAnimated:(BOOL)animated withCompletion:(void (^)(void))completion;

    - (void)moveRightAnimated:(BOOL)animated withCompletion:(void (^)(void))completion;

    - (void)moveUpAnimated:(BOOL)animated withCompletion:(void (^)(void))completion;

    - (void)moveDownAnimated:(BOOL)animated withCompletion:(void (^)(void))completion;

 

## Callbacks and MSMatrixControllerDelegate

At this moment, MSMatrixController does use the default UIKit callbacks when a view appears/disappears:

    - (void)viewDidAppear:(BOOL)animated;    

    - (void)viewDidDisappear:(BOOL)animated;

Also, it declares the delegate `MSMatrixControllerDelegate`:

    - (void)willMoveToViewController:(UIViewController *)viewController atPosition:(Position)position;

    - (void)didMoveToViewController:(UIViewController *)viewController atPosition:(Position)position;

## Credits

Freely inspired by [Circle](https://itunes.apple.com/gb/app/circle-whos-around-you/id488720081?mt=8) and [MBSpacialViewController](https://github.com/mobitar/MBSpacialViewController)

## Contact

Marco Sero

- http://www.marcosero.com

- http://twitter.com/marcosero 

- [email protected]

## License

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