carabina / dropdownmenukit

UIKit drop down menu, simple yet flexible and written in Swift

DropDownMenuKit

DropDownMenuKit is a custom UIKit control to show a menu attached to the navigation bar or toolbar. The menu appears with a sliding animation and can be deeply customized. For example, with icons, embedded controls, or a checkmark to denote a selected row among multiple menu cells.

The control is made up of three parts:

• DropDownMenu: the menu itself, a UIView subclass that contains a UITableView presenting one or more DropDownMenuCell(s)
• DropDownMenuCell: a menu entry, implemented as a UITableViewCell subclass
• DropDownMenuTitleView: an optional title view to toggle the menu, which is usually put in the navigation bar and acts as a disclosure indicator

To see in action, take a look at the very beginning of Placeboard demo video.

Compatibility

DropDownMenuKit requires iOS 8 or higher and is written in Swift 2.2.

Note: If you are interested in iOS 7 support, rewrite DropDownTitleView.imageNamed(:).

Installation

Carthage

Add the following line to your Cartfile, run carthage update to build the framework and drag the built DropDownMenuKit.framework into your Xcode project.

github "qmathe/DropDownMenuKit"

CocoaPods

Add the following lines to your Podfile and run pod install with CocoaPods 0.36 or newer.

use_frameworks!

pod "DropDownMenuKit"

Manually

If you don't use Carthage or CocoaPods, it's possible to drag the built framework or embed the source files into your project.

Framework

Build DropDownMenuKit framework and drop it into your Xcode project.

Files

Drop DropDownMenu.swift, DropDownMenuCell.swift, DropDownTitleView.swift and DropDownMenuKit.xcassets into your Xcode project.