How to customize the dropdown appearance in Dropdowns?

Use the centralized Config structure, such as setting Config.List.DefaultCell.Text.color, to modify colors, fonts, and other visual properties without subclassing, as shown in the README examples.

Dropdowns vs other iOS dropdown libraries like IQDropdownMenu?

Dropdowns is lighter and more Swift-native, focusing on simplicity and customization for basic lists, whereas IQDropdownMenu may offer more out-of-the-box features but with increased complexity. Choose Dropdowns for straightforward, UIKit-based projects.

Does Dropdowns work with Carthage or only CocoaPods?

It supports both Carthage and CocoaPods installation methods, as stated in the README, by adding the appropriate lines to your Cartfile or Podfile for flexible dependency management.

Can I use a custom view controller instead of the default list?

Yes, you can provide a custom contentController, such as a TableController or any UIViewController, to display arbitrary content in the dropdown, enabling greater flexibility beyond simple item lists.

Is Dropdowns compatible with iOS 13 and Dark Mode?

As a UIKit-based library, it works with iOS 13, but Dark Mode support requires manual configuration via the Config structure or adapting to system traits, as it doesn't handle this automatically out-of-the-box.

How to handle dropdown item selection events?

Set the action closure on the TitleView or contentController, which passes the selected index, allowing easy integration with your app's logic, as illustrated in the basic usage example.

Open-Awesome

Dropdowns

NOASSERTIONSwift3.1.0

A lightweight Swift library for presenting customizable dropdown menus in iOS apps.

Visit Website GitHub

306 stars35 forks0 contributors

What is Dropdowns?

Dropdowns is a Swift library for iOS that enables developers to quickly implement dropdown menus in their applications. It solves the need for a lightweight, customizable dropdown component that integrates seamlessly with UIKit, particularly in navigation bars. The library provides a simple API to display lists of items and handle selection actions with minimal setup.

Target Audience

iOS developers building Swift applications who need to add dropdown navigation or selection menus, especially those working with UINavigationController and looking for a customizable UI component.

Value Proposition

Developers choose Dropdowns for its simplicity, lightweight nature, and ease of customization compared to building dropdowns from scratch or using heavier third-party solutions. It offers a focused feature set tailored specifically for dropdown presentation in iOS apps.

Overview

:droplet: Fantastic dropdown in Swift

Use Cases

Best For

Adding dropdown navigation menus to iOS app navigation bars
Creating customizable selection dropdowns in Swift applications
Implementing lightweight dropdown UI components without heavy dependencies
Quickly prototyping dropdown interfaces in iOS projects
Customizing dropdown appearance and behavior in UIKit-based apps
Integrating dropdowns with UINavigationController for menu navigation

Not Ideal For

Projects built entirely with SwiftUI, as it relies on UIKit and doesn't offer native SwiftUI components
Apps requiring dropdowns with advanced features like search bars, icons, or hierarchical menus out-of-the-box
Teams seeking a heavily pre-styled, opinionated UI kit with minimal configuration effort

Pros & Cons

Pros

Swift Integration Ease

Offers a clean API with minimal code, as demonstrated in the README where setting up a dropdown requires just a few lines of Swift to display items and handle selections.

Customization Flexibility

Provides a centralized Config structure for adjusting visual aspects like colors and fonts, allowing developers to tailor appearance without modifying core components.

Lightweight Performance

Emphasizes minimal overhead with a focus on efficiency, making it suitable for performance-sensitive iOS applications without adding bloat.

UIKit Compatibility

Seamlessly integrates with UINavigationController and standard UIKit elements, ideal for traditional iOS app development workflows.

Cons

Limited to UIKit

Does not support SwiftUI, restricting its use in modern iOS projects that adopt Apple's newer declarative UI framework.

Basic Feature Set

Focuses on simple list-based dropdowns without built-in support for advanced features like search, multi-select, or complex animations, requiring custom implementation for such needs.

Configuration Overhead

While customizable, achieving non-standard appearances or behaviors may involve more manual setup compared to more comprehensive UI libraries with pre-built options.

Frequently Asked Questions

Related Projects

RESideMenu

iOS 7/8 style side menu with parallax effect.

Stars7,037

Forks1,314

Last commit8 years ago

SideMenu

Simple side/slide menu control for iOS, no code necessary! Lots of customization. Add it to your project in 5 minutes or less.

Stars5,818

Forks695

Last commit3 years ago

ViewDeck

An implementation of the sliding menu found in various iOS apps.

Stars5,261

Forks953

Last commit4 years ago

PageMenu

A paging menu controller built from other view controllers placed inside a scroll view (like Spotify, Windows Phone, Instagram)

Stars5,218

Forks873

Last commit5 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub