Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ezescaruli/ESTabBarController
A custom tab bar controller for iOS.
https://github.com/ezescaruli/ESTabBarController
Last synced: about 1 month ago
JSON representation
A custom tab bar controller for iOS.
- Host: GitHub
- URL: https://github.com/ezescaruli/ESTabBarController
- Owner: ezescaruli
- License: mit
- Created: 2015-05-04T02:30:19.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2018-02-23T00:12:29.000Z (over 6 years ago)
- Last Synced: 2024-04-29T16:08:31.370Z (5 months ago)
- Language: Objective-C
- Homepage:
- Size: 1.51 MB
- Stars: 124
- Watchers: 9
- Forks: 23
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - ESTabBarController - A tab bar controller for iOS that allows highlighting buttons and setting custom actions to them. (UI / Tab Bar)
- awesome-ios-star - ESTabBarController - A tab bar controller for iOS that allows highlighting buttons and setting custom actions to them. (UI / Tab Bar)
README
ESTabBarController
========================
`ESTabBarController` is a custom tab bar controller for iOS. It has a tab indicator that moves animated along the bar when switching between tabs. It also provides the capability of running actions associated with the tab bar buttons.
Compatible with iOS 7.0 and above.
## Installation
Simply add `ESTabBarController` to your `Podfile`:
```ruby
pod 'ESTabBarController'
```
## Usage
### Initialization
`ESTabBarController` is initialized with an array of images that represent icons for the buttons in the tab bar:
```objc
ESTabBarController *tabBarController = [[ESTabBarController alloc] initWithTabIcons:@[[UIImage imageNamed:@"firstIcon"],
[UIImage imageNamed:@"secondIcon"],
[UIImage imageNamed:@"thirdIcon"]]];
```
If the images are all loaded from the main bundle, a convenience initializer can be used:
```objc
ESTabBarController *tabBarController = [[ESTabBarController alloc] initWithTabIconNames:@[@"firstIcon", @"secondIcon", @"thirdIcon"]];
```
### View controllers
View controllers are set in the way:
```objc
[tabBarController setViewController:myFirstViewController
atIndex:0];
[tabBarController setViewController:mySecondViewController
atIndex:2];
```
Note that it is possible to have an index without an associated view controller. This can be useful when having a button that performs an action but does not switch to a view controller.
### Actions
`ESTabBarController` allows performing actions when pressing a button in the tab bar:
```objc
[tabBarController setAction:^{
// Perform an action.
} atIndex:1];
```
If there is also a controller associated with the index for an action, this is performed immediately after switching to the controller.
### Highlighted buttons
`ESTabBarController` allows having highlighted buttons. These are displayed in a different way, and are useful when trying to give more importance to a view controller or action.
```objc
[tabBarController highlightButtonAtIndex:1];
```
### Colors
`ESTabBarController` provides a way to customize two colors:
- The color of the selected buttons and the selection indicator:
```objc
tabBarController.selectedColor = [UIColor redColor]; // Any color.
```
- The background color of the buttons:
```objc
tabBarController.buttonBackgroundColor = [UIColor grayColor]; // Any color.
```
### Example
More usage information can be found in the Example project.
## License
This library is available under the [MIT license](http://www.opensource.org/licenses/mit-license.php).