• Stars
    star
    157
  • Rank 238,399 (Top 5 %)
  • Language
    Objective-C
  • License
    MIT License
  • Created over 10 years ago
  • Updated over 4 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Another UITabBar & UITabBarController (iOS Tab Bar) replacement, but uses Auto Layout for arranging it's views hierarchy.

GGTabBar

GGTabBar is a simple UITabBar & UITabBarController replacement that uses Auto Layout for constructing the GUI. I created it for curiosity, but it may be useful to others who adventure into the land of Auto Layout.

Build Status

screenshot

โš ๏ธ This is a work in progress/proof of concept, I'm no expert. Sorry if it's missing some feature you need, feel free to fork, pull request or open issues. I'm available on Twitter if you have further questions ๐Ÿ˜ฌ๐Ÿ‘Œ

Limitations ๐Ÿ’ฃ

  • Still need to add customization options (background color, tint, style, background image, etc.).
  • The tab bar items are UIButtons (no TabBarItem abstraction in a UIView).
  • No more tab if you add more than 5 View Controllers.
  • Still need to add more integration tests.

Install

CocoaPods

pod 'GGTabBar', '~> 0.0.2'

Xcode

Just copy the GGTabBar folder into your Xcode project.

Usage ๐Ÿš€

โš ๏ธ Your UIViewControllers must set their tabBarItem images (selected/normal).

Objective-C

Init and customize

GGTabBarController *tabBar = [[GGTabBarController alloc] init];
tabBar.tabBarAppearanceSettings = @{kTabBarAppearanceHeight : @(100.0)}; // in points
tabBar.viewControllers = @[vc1, vc2, vc3, vc4];
self.window.rootViewController = tabBar;

Swift

โš ๏ธ remember to add GGTabBar.h into your project's Swift Bridging Header.

var tabBar: GGTabBarController = GGTabBarController()
tabBar.tabBarAppearanceSettings = [kTabBarAppearanceHeight : 100.0];
tabBar.viewControllers = [vc1, vc2, vc3, vc4]
self.window!.rootViewController = tabBar

โš ๏ธ Feel free to explore the provided Example Project to check out how to use GGTabBar.

Structure ๐Ÿท

All the views are setup with Auto Layout. There are no CGRect, Struts or Sprints, so unless you break the constraints, everything should work on different screen-sizes.

If you want more information about how the AutoLayout Constraints are specified, please take a look at the tests. It's the best way to understand what's going on here.

hierarchy

Debug ๐Ÿ›

Normally you won't be doing any sort of Debug, but it something strange happens you can enable debugMode so that all the UIView's backgrounds are painted.

To enable debug mode:

Objective-C

tabBar.debug = YES;

Swift

tabBar.debug = true
  • Green Views: Margins, there are always exactly two of them.
  • Red Views: Separators, located between buttons.
  • Blue View: The GGTabBar.view.
  • White Views: Button backgrounds.

Emoji ๐Ÿ’ฉ

You got to freakin' โค๏ธ them ๐Ÿ˜!