https://github.com/jamesdunay/MinimalTabBar

https://github.com/jamesdunay/MinimalTabBar

Last synced: 5 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/jamesdunay/MinimalTabBar
• Owner: jamesdunay
• License: mit
• Created: 2014-12-12T00:00:34.000Z (over 10 years ago)
• Default Branch: 0.1.2
• Last Pushed: 2016-11-29T15:09:47.000Z (over 8 years ago)
• Last Synced: 2024-10-31T16:02:40.660Z (6 months ago)
• Language: Objective-C
• Size: 57.6 KB
• Stars: 150
• Watchers: 5
• Forks: 12
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• Awesome-Mobile-UI - MinimalTabBar - C |  | (ALL)
• awesome-cocoa - MinimalTabBar

README

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

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

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

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

# MinimalTabBar

A new, and elegant, solution to the TabBar on iOS. 

MinimalTabBar gets it's name by hiding once you have selected an item, leaving your `UIViewControllers` uncluttered. 

![](http://i.imgur.com/of7jv2j.gif)

## Demo

For a useable demo please look at the repo [MinimalTabBarDemo](https://github.com/jamesdunay/MinimalTabBarDemo)

## Gestures

The MinimalTabBar has a number of gestures to allow unique user-interaction. While minimized the user has three seperate gestures to control navigation.

  * **Tap** Opens the MinimalTabBar

  * **Swipe** Slides the user between adjacent `UIViewControllers`

  * **Long** Press Gives the user a complete look at the app

## Implimentation

Implimentation mirrors Apple's `UITabBar` very closely. Assuming your `UIViewControllers` have `UITabBar` items it's only two steps.

```objc

JDMinimalTabBarController *minimalTabBarViewController = [[JDMinimalTabBarController alloc] init];

```

Once you've created your MinimalTabBar assigning it `UIViewControllers` is easy. Use the `UITabBar` item's `name`, `image`, and `selectedImage` to control the look of each tab.

```objc

[minimalTabBarViewController setViewControllers:@[sectionOneVC, sectionTwoVC, sectionThreeVC, sectionFourVC, sectionFiveVC]];

```

*MinimalTabBarController's MinimalBar you can set the following attributes:*

  * `@property (nonatomic, strong) UIColor* defaultTintColor;`

  * `@property (nonatomic, strong) UIColor* selectedTintColor;`

  * `@property (nonatomic) BOOL showTitles;`

  * `@property (nonatomic) BOOL hidesTitlesWhenSelected;`

*You can also provide the MinimalBar with a background color if you so wish*

## Notes

If you have any comments or run into any errors, please let me know as I am making changes frequently. 

    

## Usage

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

## Installation

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

it, simply add the following line to your Podfile:

    pod "MinimalTabBar"

## Author

jamesdunay [at] gmail 

## License

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