A simple yet customizable Horizontal Menu for when you do not want to muck with UICollectionViews.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
MPSHorizontalMenu
MPSHorizontalMenuDemo
images
.gitignore
LICENSE
MPSHorizontalMenu.podspec
README.md

README.md

MPSHorizontalMenu

A simple yet customizable Horizontal Menu for when you do not want to muck with UICollectionViews.

Installation

If you're using CocoaPods, simply add the following line to your Podfile:

pod 'MPSHorizontalMenu'

If not then you will need to clone this project and add the files in the MPSHorizontalMenu folder to your project. I suggest dropping this in a Vendor folder. If you are git savvy then of course you can use a git submodule, but if you are that savvy then I doubt you read this sentence. ;)

Example

Screenshot

Usage

Code

Using MPSHorizontalMenu is quite simple. All you need to do is create one, add it to your view and then implement its Data Source and Delegate methods. From there, everything behaves very similar to what you might be use to with a UITableView or UICollectionView.

For more an example, check out the example project included in this repository and file an issue if you run into any problems.

// Declare this somewhere in your interface
#import "MPSHorizontalMenu.h"

@property (nonatomic, strong) MPSHorizontalMenu *horizontalMenu;
@property (nonatomic, strong) NSMutableArray *menuItems;

// Implement this somewhere in your View Controller or custom View
self.menuItems = [@[ @"Menu Item 1", @"Menu Item 2", @"Menu Item 3", @"Menu Item 4", @"Menu Item 5"] mutableCopy];

self.horizontalMenu = [[MPSHorizontalMenu alloc] initWithFrame:CGRectMake(0, 44, self.view.frame.size.width, 41)];
self.horizontalMenu.itemSelectedBackgroundColor = [UIColor blueColor];
self.horizontalMenu.dataSource = self;
self.horizontalMenu.itemSelectedDelegate = self;
self.horizontalMenu.scrollsToTop = NO;
[self.horizontalMenu reloadData];
[self.horizontalMenu setSelectedIndex:0 animated:NO];
	
// Then implement the data source and delegate methods.

#pragma mark - MPSHorizontalMenuDataSource

- (int)numberOfItemsForMenu:(MPSHorizontalMenu *)horizontalMenu {
    return [self.menuItems count];
}

- (NSString*)horizontalMenu:(MPSHorizontalMenu *)horizontalMenu titleForItemAtIndex:(NSUInteger)index {
	return [self.menuItems objectAtIndex:index];
}

#pragma mark - MPSHorizontalMenuDelegate

-(void)horizontalMenu:(MPSHorizontalMenu *)horizontalMenu itemSelectedAtIndex:(NSUInteger)index {
	if ([self.menuItems count] == 0) return;
	// Do something when the index is changed.
}

Customization

MPSHorizontalMenu can be customized in several ways. You can customize the Button's Foreground and Background colors for both Normal and Selected states:

self.horizontalMenu.itemNormalBackgroundColor = [UIColor clearColor];
self.horizontalMenu.itemNormalForegroundColor = [UIColor whiteColor];
self.horizontalMenu.itemSelectedBackgroundColor = [UIColor blackColor];
self.horizontalMenu.itemSelectedForegroundColor = [UIColor greenColor];

The same is true for the menu's background color:

self.horizontalMenu.backgroundColor = [UIColor redColor];

Credits

MPSHorizontalMenu is a port of Mugunth Kumar's MKHorizMenu. Special thanks to Mugunth for his blessing on upgrading his existing project.

Contact

License

See LICENSE.