https://github.com/felix-dumit/FSDDropdownPicker

A simple dropdown list picker for iOS
https://github.com/felix-dumit/FSDDropdownPicker

dropdown ios picker

Last synced: about 2 months ago
JSON representation

A simple dropdown list picker for iOS

• Host: GitHub
• URL: https://github.com/felix-dumit/FSDDropdownPicker
• Owner: felix-dumit
• License: mit
• Created: 2015-03-07T18:24:19.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2018-05-08T00:16:34.000Z (over 6 years ago)
• Last Synced: 2024-07-10T22:59:51.462Z (3 months ago)
• Topics: dropdown, ios, picker
• Language: Objective-C
• Homepage:
• Size: 2.53 MB
• Stars: 54
• Watchers: 6
• Forks: 10
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# FSDDropdownPicker

[![Version](https://img.shields.io/cocoapods/v/FSDDropdownPicker.svg?style=flat)](http://cocoadocs.org/docsets/FSDDropdownPicker)

[![License](https://img.shields.io/cocoapods/l/FSDDropdownPicker.svg?style=flat)](http://cocoadocs.org/docsets/FSDDropdownPicker)

[![Platform](https://img.shields.io/cocoapods/p/FSDDropdownPicker.svg?style=flat)](http://cocoadocs.org/docsets/FSDDropdownPicker)

## Example

![Example](http://gifyu.com/images/temp2.gif)

## Usage

To run the example project, clone the repo, and run `pod install` from the Example directory first.

### Create instance

You can create an intance directly by passing in an `NSArray>*` , if you just want an item with a name and image you can use the provided `FSDPickerItem` :

```objc

FSDPickerItem* item1 = [[FSDPickerItem alloc] initWithName:@"name" andImage:[UIImage imageNamed:@"1"]];

...    

FSDDropdownPicker *picker = [[FSDDropdownPicker alloc] initWithOptions:@[item1]];    

```

You will then have to add it to your view manually. You can alternatively use a convenience method to directly add the picker to the right or left of a navigation bar:

```objc 

FSDDropdownPicker *picker =  [self.navigationItem addDropdownPickerWithOptions:@[item1, item2, item3] atPosition:FSDDropdownPickerNavigationPositionRight];

```

The dropdown picker will dismiss if you tap the dropdown button again, or if you tap outside the view and you have `shouldHideOnOutsideTap` turned on.

### FSDDropdownPickerDelegate

> The delegate can respond to the following events:

```objc

picker.delegate = self;

- (void)dropdownPicker:(FSDDropdownPicker *)dropdownPicker didDropDown:(BOOL)drop {

    //do something when the picker dropped down or up

}

```

```objc

- (BOOL)dropdownPicker:(FSDDropdownPicker *)dropdownPicker 	didSelectOption:(id  )option {

	// called when user selects an option

}

```

### Customization

> You can customize the following options: 

```objc

/**

 *  The height of each option in the dropdown picker

 */

@property (assign, nonatomic) CGFloat rowHeight;

/**

 *  Whether to show images when the picker drops down or not

 */

@property (assign, nonatomic) BOOL displaysImageInList;

/**

 *  The list separator style for the picker items

 */

@property (assign, nonatomic) UITableViewCellSeparatorStyle listSeparator;

/**

*  If the dropdown should hide when a tap outside (rest of window) happens. Default= YES

*/

@property (assign, nonatomic) BOOL shouldHideOnOutsideTap;

```

## Installation

 FSDDropdownPicker is available through [CocoaPods](http://cocoapods.org). To install

it, simply add the following line to your Podfile:

    pod "FSDDropdownPicker"

 

  Or to view the example project:

    ```

    pod try "FSDDropdownPicker"

    ```

 

 Pull requests or any suggestions are **welcome**

## Author

Felix Dumit, [email protected]

## License

FSDDropdownPicker is available under the MIT license. See the LICENSE file for more info.