https://github.com/azimin/aztabbarcontroller

Custom TabBar Controller for iOS
https://github.com/azimin/aztabbarcontroller

tabbar

Last synced: 3 months ago
JSON representation

Custom TabBar Controller for iOS

• Host: GitHub
• URL: https://github.com/azimin/aztabbarcontroller
• Owner: azimin
• License: mit
• Created: 2016-11-15T00:04:18.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2018-02-06T13:43:48.000Z (over 8 years ago)
• Last Synced: 2025-05-03T04:59:31.822Z (about 1 year ago)
• Topics: tabbar
• Language: Swift
• Size: 813 KB
• Stars: 37
• Watchers: 3
• Forks: 6
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# AZTabBarController

[![CocoaPods Compatible](https://img.shields.io/cocoapods/v/AZTabBarController.svg)](https://img.shields.io/cocoapods/v/AZTabBarController.svg)

[![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

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

[![Twitter](https://img.shields.io/badge/twitter-@ziminalex-blue.svg?style=flat)](http://twitter.com/ziminalex)

![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)

AZTabBarController helps to extend capabilities of default `UITabBarController` and create custom `UITabBar` items with custom appearance (with animations, layout and so on). Right now works only with storyboard setup (so your `UITabBarController` should be on storybaord).

## Visual Example

Inside this repository you can try `iOS Example` target with example of `AZTabBarController` implementation and custom items (`FashionTabBarItem.swift` and `MiddleTabBarItem`):

![Animation example](imgs/animation_example.gif)

## Installation

- Add the following to your [`Podfile`](http://cocoapods.org/) and run `pod install`

```ruby

pod 'AZTabBarController'

```

- or add the following to your [`Cartfile`](https://github.com/Carthage/Carthage) and run `carthage update`

```ruby

github "azimin/AZTabBarController"

```

- or clone as a git submodule,

- or just copy `Source/AZTabBarController.swift` and `Source/UIView+Extensions.swift` into your project.

## AZTabBarController setup in storyboard

At first you should change `UITabBarController` to `AZTabBarController` on storyboard.

![First setup step](imgs/setup_1.png)

Then change `UITabBar` to `AZTabBar` on the same storyboard.

![Second setup step](imgs/setup_2.png)

Then change all `UITabBarItem` to `AZTabBarItem` on this storyboard.

![Third setup step](imgs/setup_3.png)

Also don't forget to implement code inside your view controllers for tab bar. This example you can find in Demo `iOS Example` project:

```swift

override func az_tabBarItemContentView() -> AZTabBarItemView {

  let tab = FashionTabBarItem.loadViewFromNib()

    

  tab.imageView.image = UIImage(named: "img_profile")

  tab.bottomLabel.text = "Profile"

    

  return tab

}

```

## Possible assertions

- `All tab bar items must be AZTabBarItem class` means one of your root view contllers on tab bar has `UITabBarItem` class instead of `AZTabBarItem`

- `tabBar class must be AZTabBar class` means you tabBar on UITabBarViewController is `UITabBar`, but should be `AZTabBar`

## Dynamic height

- You can setup default height on storybaord as @IBInspectable `AZTabBarController` property

- If you want to change height of tab bar, you can call (on any chird view controllers):

```swift

self.az_tabBarController?.preferedHeight = 125

```

This would change `Bottom Layout Guide`

- If you want to change height of specific items, you should use `heightValue` of your `AZTabBarItemView`, so it would be:

```swift

override func az_tabBarItemContentView() -> AZTabBarItemView {

  let tab = MiddleTabBarItem.loadViewFromNib()

    

  tab.heightValue = 50

    

  return tab

}

```

But pay attention that `Bottom Layout Guide` would use old value.

## To-do

- Support iOS 8+ (moved from anchors to cosntraints)

- Support creation from code (right now only storyboard)

- Support `AZTabBarItemView` without xib

- Add some template `AZTabBarItemView` subsclasses

- Improve example