##Example
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
of items that conform to the FSDPickerItemProtocol
, if you just want an item with a name and image you can use the provided FSDPickerItem
:
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 of a navigation bar:
FSDDropdownPicker *picker = [self.navigationItem addDropdownPickerWithOptions:@[item1, item2, item3]];
The dropdown picker will dismiss if tapped outside or tapped the dropdown button.
###FSDDropdownPickerDelegate
The delegate can respond to the following events:
picker.delegate = self;
- (void)dropdownPicker:(FSDDropdownPicker *)dropdownPicker didDropDown:(BOOL)drop {
//do something when the picker dropped down or up
}
- (BOOL)dropdownPicker:(FSDDropdownPicker *)dropdownPicker didSelectOption:(id <FSDPickerItemProtocol> )option {
// called when user selects an option
}
###Customization
You can customize the following options:
/**
* 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;
FSDDropdownPicker is available through CocoaPods. 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
Felix Dumit, felix.dumit@gmail.com
FSDDropdownPicker is available under the MIT license. See the LICENSE file for more info.