BTNavigationDropdownMenu: A Swift repository from aybar

Introduction:

The elegant dropdown menu, written in Swift, appears underneath navigation bar to display a list of related items when a user click on the navigation title.

Installation:

BTNavigationDropdownMenu is available through CocoaPods. To install it, simply add the following line to your Podfile:

use_frameworks!
pod 'BTNavigationDropdownMenu'

Go ahead and import BTNavigationDropdownMenu into your own Swift files

import BTNavigationDropdownMenu

Note: This library mainly supports for Xcode 7, Swift 2.0 and embedded frameworks. For older versions of XCode, use branch swift-1.2

Usage:

Instantiating

Start by creating an Array that contains strings as elements of dropdown list:

let items = ["Most Popular", "Latest", "Trending", "Nearest", "Top Picks"]

Create a new instance of BTNavigationDropdownMenu:

let menuView = BTNavigationDropdownMenu(title: items.first!, items: items)

Set title of navigation bar as menuView:

self.navigationItem.titleView = menuView

Call BTNavigationDropdownMenu closure to get the index of selected cell:

menuView.didSelectItemAtIndexHandler = {(indexPath: Int) -> () in
            println("Did select item at index: \(indexPath)")
            self.selectedCellLabel.text = items[indexPath]
}

Customization

Once you have assigned the items and frame for dropdown menu, you can custom the look and the feel of menu. You can override these properties for your favor:

cellHeight - The height of the cell. Default is 50

cellBackgroundColor - The color of the cell background. Default is whiteColor()

cellSeparatorColor - The color of the cell separator. Default is darkGrayColor()

cellTextLabelColor - The color of the text inside cell. Default is darkGrayColor()

cellTextLabelFont - The font of the text inside cell. Default is HelveticaNeue-Bold, size 19

cellSelectionColor - The color of the cell when the cell is selected. Default is lightGrayColor()

checkMarkImage - The checkmark icon of the cell.

animationDuration - The animation duration of showing/hiding menu. Default is 0.5s

bounceOffset - The value of bounce offset. Default is 10

arrowImage - The arrow next to navigation title

arrowPadding - The padding between navigation title and arrow. Default is 15

maskBackgroundColor - The color of the mask layer. Default is blackColor()

maskBackgroundOpacity - The opacity of the mask layer. Default is 0.3

Requirement

iOS 8.0+ (Cocoapods with Swift support will only work on iOS 8.0+. Alternatively, you will have to import library manually to your project)
Xcode 7.0, Swift 2.0

Changelog

0.1.7 (04-09-2015)

Use optional for some properties that relating to navigation controller

0.1.6 (28-08-2015)

No need to use containerView param when initializing menuView now

0.1.5 (27-08-2015)

Support device orientation
Support Split View on iPad

0.1.4 (26-08-2015)

Fixed issue [#5] (PhamBaTho#5). The dropdown overlay appears overtop the tab bar now
Refactoring and clean up

0.1.3 (25-07-2015)

Use usingSpringWithDamping instead of contentOffset for show/hide animation

0.1.2 (21-07-2015)

Allow change of arrow image after creation of menu

License

BTNavigationDropdownMenu is available under the MIT License. See the LICENSE for details.

aybar/BTNavigationDropdownMenu