by Azuritul

Azuritul / AZDropdownMenu

A simple dropdown menu component for iPhone

197 Stars 51 Forks Last release: Not found MIT License 65 Commits 9 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


Build Status Version License Platform Language

AZDropdownMenu is a simple dropdown menu component that supports Swift.


Code used in the screencast are included in the bundled sample project.


Demo Project

To run the demo project, clone the repo with

git clone
, and run
pod install
from the Example directory first.


  • iOS 8 or above
  • Xcode 8 or above
  • Swift 3


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

pod 'AZDropdownMenu'

Use version 1.1.2 if you don't need Swift 4 support.


Declare an array of texts that are served as the item in the menu.

let titles = ["Action 1", "Action 2", "Action 3"]
Then pass the array to the initializer
let menu = AZDropdownMenu(titles: titles)

Set up so that the

is asso

ated with a function that shows the menu

let button = UIBarButtonItem(image: UIImage(named: "menu_image"), style: .Plain, target: self, action: "showDropdown")
navigationItem.leftBarButtonItem = menuButton


public func showMenuFromView(view:UIView)
can then show the menu.
func showDropdown() {
    if ( == true) {
    } else {

The handler

public var cellTapHandler : ((indexPath:NSIndexPath) -> Void)?
would be called when menu item is tapped. So place code in here to do whatever you want. For example
menu.cellTapHandler = { [weak self] (indexPath: NSIndexPath) -> Void in
    self?.navigationController?.pushViewController(controller, animated:true)

Create menu with icons

Pass in a AZDropdownMenuItemData in the initializer:

public init(dataSource:[AZDropdownMenuItemData])
and you are good to go.

Take a look at the sample project in this repository to get more usage of the library.

Configurable options

Currently AZDropdownMenu can be customized with the following properties. More will come in the future.

  • itemHeight
    Row height of the menu item. Default is 44.
  • itemColor
    The background color of the menu item. Default is white.
  • itemFontColor
    The text color of the menu item. Default is black.
  • itemFontSize
    Font size of the menu item. Default is 14.0
  • itemFont
    Font used in the menu. Default is 'Helvetica'
  • itemAlignment
    The alignment of the menu item. Default is left-aligned.
  • itemSelectionColor
    The background color of the menu item while it is tapped. Default is gray.
  • overlayAlpha
    The transparency for the background overlay. Default is 0.5
  • overlayColor
    Color for the background overlay. Default is black.
  • menuSeparatorStyle
    The separator of the menu. Default is single line.
  • menuSeparatorColor
    The color of the separator. Default is light gray.
  • itemImagePosition
    The position of image in the menu. Can be positioned before or after the text. Default is
  • shouldDismissMenuOnDrag
    If set to true, menu would be dismissed on drag. Default value is


  • 1.1.3

    • Update for Swift 4 syntax
  • 1.1.2

    • Update for Swift 3 syntax
  • 1.1.1

    • Update for Swift 2.2's #selector syntax
  • 1.1.0

    • Added
      option, menu would be dismissed on drag if this option is enabled
    • Modified the sample project with an example using
    • Added gesture handler for the menu.
    • Extract config struct to a separate file
    • Update readme.
  • 1.0.0

    • Added
      option, now can configure the icon position.
    • Changed icon sets and its corresponding location in the sample project.
    • Modified sample project's appearance a little bit.
    • Modified sample project's structure.
    • Added
  • 0.6.1

    • Update readme
  • 0.6.0

    • Now can use icons in the menu.
    • Added configuration options:
  • 0.5.3

    • Now can configure item's background color while tapped



Chris Wu (Azuritul), [email protected]


AZDropdownMenu is available under the MIT license. See the LICENSE file for more info.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.