m3g0byt3 / dsdmenu

A dead-simpe, UIKit-based dropdown menu, written in Swift

DSDMenu

— Dead Simpe Dropdown Menu

A simple drop-down menu written in Swift.

Features

---

• Automatically update menu button content based on selected cell
• Use delegate or configuration closure to setup menu
• Use default or custom menu cells (with and without NIBs)
• Create menu programmatically or in the Interface Builder

Requirements

---

• iOS 9.0+
• Xcode 9.0+
• Swift 4.0+

Example

---

To run the example project, clone the repo, and run pod install from the Example directory first.

Installation

---

DSDMenu is available via CocoaPods.

CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects. You can install it with the following command:

$ sudo gem install cocoapods

To integrate DSDMenu, simply add the following line to your Podfile:

pod 'DSDMenu'

Then, run the following command:

pod install

Usage

---

Initialization:

1. Programmatically:

   Use convenience initializer:

   init(title: String, frame: CGRect = CGRect.zero)

2. Using Interface Builder

   Place a UIButton object on the storyboard and change custom class as pictured below:

   

Customize menu behaviour:

DSDMenu can be customized and controlled using two ways (mutually exclusive!):

1. Using delegete (old-way):

   Confrom to DropDownDelegate protocol and assign delegate:

   1. Programmatically:

      menu.delegate = self

   2. Using Interface Builder:

      

2. Using configuration closure (new-way):

   Instantiate menu instance, then pass closure with a DropDownMenuConfigurator instance inside, configured within this closure, to the configure(using: (DropDownMenuConfigurator) -> Void) method:

   menu.configure { configurator in
     configurator.cellClass(DropDownCell.self)
                 .numberOfItems(10)
                 .updateThumbnailOnSelection(true)
                 .didSelectItem { index in print(index) }
                 .willDisplayCell { (cell, index) in print(cell, index) }
   }

API reference:

---

Delegate method	Configuration method equivalent	Description
numberOfItems(in:)	numberOfItems(_:)	Asks the delegate for the number of items in menu
cellClass(for:)	cellClass(_:)	Asks the delegate for the cell class used in menu
dropDownMenu(_:didSelectItemAt:)	didSelectItem(_:)	Tells the delegate that the item in the menu was tapped
dropDownMenu(_:willDisplay:forRowAt:)	willDisplayCell(_:)	Tells the delegate that the cell in the menu is about to be displayed
updateThumbnailOnSelection(in:)	updateThumbnailOnSelection(_:)	Asks the delegate whether the menu should update thumbnail image automatically on selection

TODO Section

---

• Configure using closure instead of delegate
• Auto-update view based on selected cell's content
• Setup constraints in updateConstraints() (see also)
• Setup Pod
• Complete README
• Correct handling of orientation changes when updateThumbnailOnSelection = true
• Use POP for cells instead subclassing (if possible?)
• Allow to customize menu's appearance (shadows, colors, etc)
• Unit and UI tests
• Rx extension

Contributing

---

Contributing is always welcomed, just follow these steps:

1. Fork
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

That's it!

Author

---

m3g0byt3

License

---

DSDMenu is released under an MIT license. See LICENSE for more information.