Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/qmathe/DropDownMenuKit
UIKit drop down menu, simple yet flexible and written in Swift
https://github.com/qmathe/DropDownMenuKit
control dropdown dropdown-menu ios menu navigation navigation-bar popup swift tableview ui uikit
Last synced: 6 days ago
JSON representation
UIKit drop down menu, simple yet flexible and written in Swift
- Host: GitHub
- URL: https://github.com/qmathe/DropDownMenuKit
- Owner: qmathe
- License: other
- Created: 2016-08-02T09:56:19.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-03-05T15:02:30.000Z (almost 2 years ago)
- Last Synced: 2024-04-24T14:50:41.166Z (8 months ago)
- Topics: control, dropdown, dropdown-menu, ios, menu, navigation, navigation-bar, popup, swift, tableview, ui, uikit
- Language: Swift
- Size: 110 KB
- Stars: 301
- Watchers: 12
- Forks: 38
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - DropDownMenuKit - A simple, modular and highly customizable UIKit menu, that can be attached to the navigation bar or toolbar, written in Swift. (UI / Menu)
- awesome-ios-star - DropDownMenuKit - A simple, modular and highly customizable UIKit menu, that can be attached to the navigation bar or toolbar, written in Swift. (UI / Menu)
README
DropDownMenuKit
===============
[](https://travis-ci.org/qmathe/DropDownMenuKit)
[](http://www.apple.com)
[](https://swift.org)
[](https://github.com/qmathe/DropDownMenuKit/LICENSE)
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](http://www.placeboardapp.com) demo video.
Compatibility
-------------
DropDownMenuKit requires at least Xcode 10.2 (introducing Swift 5) and supports iOS 11 and higher.
For versions compatible with Swift 3 and 4, see branches named _swift-3/4.x_.
For now, the code base remains compatible with older iOS versions (8 or higher), but these older
versions are not supported anymore.
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 1.9 or newer.
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.
App Extension Usage
-------------------------
### Build Settings
Add **-DAPP_EXTENSION** to _DropDownMenuKit > Build Settings > Other Swift Flags_.
### Restrictions
- `DropDownMenuCell.menuAction` must take a single argument
- `DropDownMenuCell.menuTarget` must not be nil