Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/onmyway133/EasyDropdown
:droplet: Fantastic dropdown in Swift
https://github.com/onmyway133/EasyDropdown
dropdown ios menu navigationbar swift
Last synced: 6 days ago
JSON representation
:droplet: Fantastic dropdown in Swift
- Host: GitHub
- URL: https://github.com/onmyway133/EasyDropdown
- Owner: onmyway133
- License: other
- Created: 2016-08-02T21:22:25.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-02-02T07:09:34.000Z (almost 3 years ago)
- Last Synced: 2024-05-29T04:52:21.788Z (7 months ago)
- Topics: dropdown, ios, menu, navigationbar, swift
- Language: Swift
- Homepage: https://onmyway133.com
- Size: 3.27 MB
- Stars: 308
- Watchers: 10
- Forks: 33
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-ios - Dropdowns - 💧 Dropdown in Swift (UI / Menu)
- stars - EasyDropdown
- stars - EasyDropdown
README
# Dropdowns
❤️ Support my app ❤️
- [Push Hero - pure Swift native macOS application to test push notifications](https://www.producthunt.com/posts/push-hero-2)
- [Quick Access - Organise files in the Mac menu bar](https://www.producthunt.com/posts/quick-access)
- [Frame recorder - Recorder gif and video with frame](https://www.producthunt.com/posts/frame-recorder)
- [Other apps](https://onmyway133.github.io/projects/)
❤️❤️😇😍🤘❤️❤️
Dropdown in Swift
[](http://cocoadocs.org/docsets/Dropdowns)
[](http://cocoadocs.org/docsets/Dropdowns)
[](http://cocoadocs.org/docsets/Dropdowns)
## Usage
`Dropdowns` provides the quickest way to present a dropdown in your app. It is very lightweight, just provide a list of items and the action closure you want to handle.
### Basic
`Dropdowns` works by showing a child `UIViewController` as a dropdown from a `TitleView`. The most common use case is to show from a `UINavigationController`, in that sense, you can just create a list of items, and provide to `TitleView`.
```swift
let items = ["World", "Sports", "Culture", "Business", "Travel"]
let titleView = TitleView(navigationController: navigationController!, title: "Menu", items: items)
titleView?.action = { [weak self] index in
print("select \(index)")
}
navigationItem.titleView = titleView
```
### Customization
`Dropdowns` uses `TableController` by default, to show list of items in a `UITableView`. You can customise to show anything you want by using `contentController`.
```swift
let contentController = TableController(items: items, initialIndex: 0)
let dropdown = DropdownController(contentController: contentController, navigationController: navigationController)
```
### Configuration
You can also customise many aspects of `Dropdowns` via `Config`
```swift
Config.List.DefaultCell.Text.color = UIColor.redColor()
```
## Installation
**Dropdowns** is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'Dropdowns'
```
**Dropdowns** is also available through [Carthage](https://github.com/Carthage/Carthage).
To install just write into your Cartfile:
```ruby
github "onmyway133/Dropdowns"
```
**Dropdowns** can also be installed manually. Just download and drop `Sources` folders in your project.
## Author
- Khoa Pham, [email protected]
## Credit
- Hyper Interaktiv AS, [email protected]
## Contributing
We would love you to contribute to **Dropdowns**, check the [CONTRIBUTING](https://github.com/onmyway133/Dropdown/blob/master/CONTRIBUTING.md) file for more info.
## License
**Dropdowns** is available under the MIT license. See the [LICENSE](https://github.com/onmyway133/Dropdown/blob/master/LICENSE.md) file for more info.