putitonmytabbar's Introduction

PutItOnMyTabBar 🍻

A subclass of UITabBarController that is customizable

Examples

Normal

Slider

Background

Small Slider

Requirements

Swift 3.0
iOS 10.0+
Xcode 8.0

Features

Easy to implement
Change slider width and height
Change colors of any element

Installation

CocoaPods ☕️

You can use CocoaPods to install PutItOnMyTabBar by adding it to your Podfile:

pod 'PutItOnMyTabBar'

Example

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

Usage

To get the full benefits import PutItOnMyTabBar in your TabBarController file:

import PutItOnMyTabBar

Simply inherit 'PutItOnMyTabBarController' and override the neccessary functions to customize!

class MyTabBarController: PutItOnMyTabBarController{
    // MARK: Mandatory Functions Child Class must override
    //Specifies how many tabs there are
    override func numberOfTabs() -> Int{
        return 3
    }

    //Gives TabBar all of the images it needs for when a tab is highlighted (in order of Tabs)
    override func highLightedImages() -> [UIImage] {
        return [image1, image2, image3]
    }

    //Gives TabBar all of the images it needs for when a tab is not selected (in order of Tabs) 
    override func unHighlightedImages() -> [UIImage] {
        return [image1, image2, image3]
    }

    // MARK: Optional Overrides 
    // Gives Background to Tab Bar - Default is white 
    override func backgroundColor() -> UIColor{
        return .white
    }

    // Optional Slider View that moves to selected Tab - Default is clear
    override func sliderColor() -> UIColor {
        return .clear
    }

    // Sets the height of a slider as a percentage of the total tab bar height - Default is 10%
    override func sliderHeightMultiplier() -> CGFloat {
        return 0.1
    }

    // Sets the sliders width as a percentage of each tab bars width - Default is 100%
    override func sliderWidthMultiplier() -> CGFloat {
        return 1.0
    }
}