Swiftpack.co - skywinder/ActionSheetPicker-3.0 as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
Quickly reproduce the dropdown UIPickerView / ActionSheet functionality on iOS.
.package(url: "https://github.com/skywinder/ActionSheetPicker-3.0.git", from: "2.7.1")


Version Carthage compatible Build Status Issues License PlatformAll Contributors

Important update

Now I fixed most of the things and merge PR' (thanks to All Contributors).

I did much work to support this library from iOS 5. (and till iOS 13 and we keep going) πŸš€

I still need help with the future support of this repo. If you are interested to help - please drop a comment into issue #348 πŸ™

Regards, Petr Korolev

Please welcome: ActionSheetPicker-3.0!

ActionSheetPicker = UIPickerView + UIActionSheet


Well, that's how it started. Now, the following is more accurate:

  • iPhone/iPod ActionSheetPicker = ActionSheetPicker = A Picker + UIActionSheet
  • iPad ActionSheetPicker = A Picker + UIPopoverController


Easily present an ActionSheet with a PickerView, allowing the user to select from a number of immutable options.


  • Spawn pickers with convenience function - delegate or reference not required. Just provide a target/action callback.
  • Add buttons to UIToolbar for quick selection (see ActionSheetDatePicker below)
  • Delegate protocol available for more control
  • Universal (iPhone/iPod/iPad)


There are 4 distinct picker view options:

  • ActionSheetStringPicker
  • ActionSheetDistancePicker
  • ActionSheetDatePicker
  • ActionSheetCustomPicker

We'll focus here on how to use the ActionSheetStringPicker since it's most likely the one you want to use.

Basic Usage

For detailed info about customizations, please look BASIC USAGE

  • Custom buttons view
  • Custom buttons callbacks
  • Action by clicking outside of the picker
  • Background color and blur effect
  • Other customizations

For detailed examples, please check Example Projects in this repo.


 ActionSheetMultipleStringPicker.show(withTitle: "Multiple String Picker", rows: [
            ["One", "Two", "A lot"],
            ["Many", "Many more", "Infinite"]
            ], initialSelection: [2, 2], doneBlock: {
                picker, indexes, values in

                print("values = \(values)")
                print("indexes = \(indexes)")
                print("picker = \(picker)")
        }, cancel: { ActionMultipleStringCancelBlock in return }, origin: sender)


// Inside a IBAction method:

// Create an array of strings you want to show in the picker:
    NSArray *colors = @[@"Red", @"Green", @"Blue", @"Orange"];

// Done block:
    ActionStringDoneBlock done = ^(ActionSheetStringPicker *picker, NSInteger selectedIndex, id selectedValue) {
        NSLog(@"Picker: %@", picker);
        NSLog(@"Selected Index: %@", @(selectedIndex));
        NSLog(@"Selected Value: %@", selectedValue);

// cancel block:
    ActionStringCancelBlock cancel = ^(ActionSheetStringPicker *picker) {
        NSLog(@"Block Picker Canceled");

// Run!
    [ActionSheetStringPicker showPickerWithTitle:@"Select a Color" rows:colors initialSelection:0 doneBlock:done cancelBlock:cancel origin:sender];



pod 'ActionSheetPicker-3.0'

(iOS 5.1.1-13.x compatible!)

CocoaPods is a dependency manager for Cocoa projects.

You can install it with the following command:

gem install cocoapods

To integrate ActionSheetPicker-3.0 into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'

pod 'ActionSheetPicker-3.0'

Then, run the following command:

pod install

Import to project

To import pod you should add string:

  • For Obj-c projects:
   #import "ActionSheetPicker.h"
  • For Swift projects:
  import ActionSheetPicker_3_0


Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

brew update
brew install carthage

To integrate ActionSheetPicker-3.0 into your Xcode project using Carthage, specify it in your Cartfile:

github "skywinder/ActionSheetPicker-3.0"

Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into Xcode and the Swift compiler.

If you are using Xcode 11 or later:

  1. Click File
  2. Swift Packages
  3. Add Package Dependency...
  4. Specify the git URL for ActionSheetPicker-3.0.


If you prefer not to use either of the aforementioned dependency managers, you can integrate ActionSheetPicker-3.0 into your project manually.

The "old school" way is manually added to your project all from Pickers folder.

Embedded Framework

  • Add ActionSheetPicker-3.0 as a submodule by opening the Terminal, cd-ing into your top-level project directory, and entering the following command:
git submodule add https://github.com/skywinder/ActionSheetPicker-3.0.git
  • Open the ActionSheetPicker-3.0 folder, and drag CoreActionSheetPicker.xcodeproj into the file navigator of your app project.
  • In Xcode, navigate to the target configuration window by clicking on the blue project icon, and selecting the application target under the "Targets" heading in the sidebar.
  • Ensure that the deployment target of CoreActionSheetPicker.framework matches that of the application target.
  • In the tab bar at the top of that window, open the "Build Phases" panel.
  • Expand the "Target Dependencies" group, and add CoreActionSheetPicker.framework.
  • Click on the + button at the top left of the panel and select "New Copy Files Phase". Rename this new phase to "Copy Frameworks", set the "Destination" to "Frameworks", and add CoreActionSheetPicker.framework.

Example Projects

open ActionSheetPicker-3.0.xcworkspace

Here is 3 projects:

  • CoreActionSheetPicker - all picker files combined in one Framework. (available since iOS 8)
  • ActionSheetPicker - modern and descriptive Obj-C project with many examples.
  • Swift-Example - example, written on Swift. (only with basic 3 Pickers examples, for all examples please run ActionSheetPicker project)


ActionSheetPicker ActionSheetDatePicker ActionSheetDatePicker CustomButtons iPad Support

Apps using this library

If you've used this project in a live app, please let me know! Nothing makes me happier than seeing someone else take my work and go wild with it.

If you are using ActionSheetPicker-3.0 in your app or know of an app that uses it, please add it to this list.

Maintainer and Contributor

  • Petr Korolev (update to iOS 7 and iOS 8, implementing new pickers, community support). I did much work to support this library from iOS 5. (and till iOS 13 and we keep going πŸš€).

Now I fixed most of the things and merge PR' (thanks to All Contributors!).

I still need help with the future support of this repo. If you are interested to help - please drop a comment into issue #348 πŸ™


  1. Create an issue to discuss your idea
  2. Fork it https://github.com/skywinder/ActionSheetPicker-3.0/fork
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request

Bug reports, feature requests, patches, well-wishes, and rap demo tapes are always welcome.


We have a Discord channel where discuss about new ideas and implementation. Feel free to join and discuss with us!

You can join our Discord using this link.


  • ActionSheetPicker was originally created by Tim Cinel (@TimCinel) Since the Tim's repo is not support iOS 7+, I forked from his repo and implement iOS 7-8 support, and also a bunch of UI fixes, crash-fixes, and different customization abilities.

  • And most of all, thanks to ActionSheetPicker-3.0's growing list of contributors.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Petr Korolev

πŸ’» πŸ‘€ πŸ’¬ πŸ’‘

Tim Cinel

πŸ’» πŸ‘€ πŸ“–

JurΔ£is ΔΆirΕ‘akmens

πŸ’¬ πŸ’‘



Vinh Tran

πŸ’» πŸ›‘οΈ

Kashif Hisam



πŸ’» πŸ›‘οΈ

Seth Delackner


Zheng Li



πŸ’¬ πŸ’» πŸ–‹ 🚧





Koji Hasegawa


Ali Ersoz




Ricardo Hernandez


Vincent Narbot


Ezequiel França


Nikola Mladenovic


Umer Asif




Manuel Kunz

πŸ’» πŸ‘€ πŸ“–

Noor ul Ain Ali

πŸ’» πŸ‘€ 🚧

This project follows the all-contributors specification. Contributions of any kind welcome!


Stars: 3369
Last commit: 2 weeks ago

Ad: Job Offers

iOS Software Engineer @ Perry Street Software
Perry Street Software is Jack’d and SCRUFF. We are two of the world’s largest gay, bi, trans and queer social dating apps on iOS and Android. Our brands reach more than 20 million members worldwide so members can connect, meet and express themselves on a platform that prioritizes privacy and security. We invest heavily into SwiftUI and using Swift Packages to modularize the codebase.

Submit a free job ad (while I'm testing this). The analytics numbers for this website are here.

Release Notes

Release 1.0.10
7 years ago

Crash and UI fixes.

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics