How do I customize the toolbar buttons in ActionSheetPicker-3.0?

Refer to the BASIC-USAGE.md file linked in the README, which details setting custom button titles, actions, and styles through picker properties after initialization. This allows for tailored UI but requires extra configuration steps.

ActionSheetPicker-3.0 vs native UIPickerView: which is better for a simple list?

ActionSheetPicker-3.0 is ideal for modal, action-sheet style selections with minimal code, while native UIPickerView is better for inline pickers within a view. ActionSheetPicker simplifies callback handling but adds a dependency.

Does ActionSheetPicker-3.0 work with SwiftUI?

It is built with UIKit and requires bridging via UIViewRepresentable for SwiftUI integration. The library lacks native SwiftUI support, so expect additional setup and potential compatibility issues.

How to handle multiple column selections in ActionSheetPicker-3.0?

Use ActionSheetMultipleStringPicker, as shown in the Swift example in the README, which supports arrays of arrays for data and initial selections. This handles multi-column pickers with done/cancel callbacks.

Is ActionSheetPicker-3.0 still maintained for iOS 15 and above?

The README mentions support up to iOS 13 with ongoing efforts, but check GitHub issues and the maintainer's call for help in #348 for current status. Updates may lag behind Apple's latest releases.

How to install ActionSheetPicker-3.0 with CocoaPods?

Add 'pod ActionSheetPicker-3.0' to your Podfile and run pod install, as detailed in the Installation section. It supports iOS 5.1.1-13.x, ensuring compatibility with older projects.

Open-Awesome

ActionSheetPicker-3.0

BSD-3-ClauseObjective-C2.8.0

An iOS library to quickly present picker views (string, date, distance, custom) as action sheets or popovers.

Visit Website GitHub

3.4k stars732 forks0 contributors

What is ActionSheetPicker-3.0?

ActionSheetPicker-3.0 is an open-source iOS library that provides ready-to-use picker controls presented as action sheets or popovers. It solves the problem of quickly implementing user selection interfaces for strings, dates, distances, and custom data without writing repetitive delegate code. Developers can integrate it to present intuitive picker modals that match native iOS behavior.

Target Audience

iOS developers (using Objective-C or Swift) who need to add picker selection interfaces to their apps, particularly those looking for a drop-in solution that works across iPhone and iPad with minimal setup.

Value Proposition

Developers choose ActionSheetPicker-3.0 because it offers a battle-tested, easy-to-integrate library with multiple picker types out of the box. Its extensive iOS version support (from iOS 5.1.1 onward) and active maintenance make it a reliable choice over building custom picker implementations from scratch.

Overview

Quickly reproduce the dropdown UIPickerView / ActionSheet functionality on iOS.

Use Cases

Best For

Adding a color or category selection dropdown in an iOS settings screen
Implementing a date or time picker in a form without custom UI work
Creating a measurement unit selector (e.g., distance, weight) in utility apps
Building custom pickers with specialized data arrays in Swift or Objective-C
Ensuring consistent picker behavior across iPhone and iPad interfaces
Quickly prototyping selection interfaces with minimal code

Not Ideal For

Apps built entirely with SwiftUI requiring seamless picker integration
Projects demanding highly non-native, custom-designed picker interfaces
Teams prioritizing zero third-party dependencies for security or simplicity
Modern iOS apps exclusively targeting iOS 14+ with a focus on latest UI frameworks

Pros & Cons

Pros

Broad iOS Compatibility

Supports iOS from 5.1.1 through iOS 13 and beyond, as stated in the README, ensuring long-term usability for legacy and current projects.

Multiple Picker Types

Includes ActionSheetStringPicker, ActionSheetDatePicker, ActionSheetDistancePicker, and ActionSheetCustomPicker, covering common selection scenarios without extra coding.

Device-Aware Presentation

Automatically adapts to iPhone (UIActionSheet) and iPad (UIPopoverController), providing a native experience across devices as highlighted in the overview.

Simplified Integration

Uses callback blocks instead of delegates, shown in the QuickStart examples, reducing boilerplate code for quick implementation.

Cons

Maintenance Uncertainty

The maintainer has publicly sought help for future support in issue #348, raising concerns about long-term viability and updates for newer iOS versions.

UIKit-Centric Design

Primarily built for UIKit, making integration with modern SwiftUI projects cumbersome and requiring additional bridging code.

Customization Complexity

Advanced UI customizations, like toolbar buttons or blur effects, require referring to a separate BASIC-USAGE.md file, adding setup effort for non-basic use cases.

Frequently Asked Questions

Related Projects

Mandoline

An iOS picker view to serve all your "picking" needs

Stars883

Forks33

Last commit7 years ago

DatePickerDialog

Date picker dialog for iOS

Stars589

Forks177

Last commit2 years ago

PickerView

🔸 A customizable alternative to UIPickerView in Swift.

Stars525

Forks88