aaaliua/akpickerview

A simple but customizable horizontal picker view.

AKPickerView

A simple yet customizable horizontal picker view.

Works on iOS 6, 7 and 8.

News: AKPickerView now supports images!

Installation

Use CocoaPods

pod "AKPickerView"

…or simply add AKPickerView.h/m into your project.

Usage

1. Instantiate and set delegate as you know,

    self.pickerView = [[AKPickerView alloc] initWithFrame:<#frame#>];
    self.pickerView.delegate = self;
   

2. then specify the number of items using delegate methods,

    - (NSUInteger)numberOfItemsInPickerView:(AKPickerView *)pickerView;
   

3. and specify contents to be shown. You can use either texts or images:

    - (NSString *)pickerView:(AKPickerView *)pickerView titleForItem:(NSInteger)item;
    // OR
    - (UIImage *)pickerView:(AKPickerView *)pickerView imageForItem:(NSInteger)item;
   

   • Using both texts and images are currently not supported. When you implement both, -pickerView:titleForItem will be called and the other won't.
   • You currently cannot specify image sizes; AKPickerView shows the original image in its original size. Resize your images in advance if you need.

4. You can change its appearance with properties below.

    @property (nonatomic, strong) UIFont *font;
    @property (nonatomic, strong) UIFont *highlightedFont;
    @property (nonatomic, strong) UIColor *textColor;
    @property (nonatomic, strong) UIColor *highlightedTextColor;
    @property (nonatomic, assign) CGFloat interitemSpacing;
    @property (nonatomic, assign) CGFloat fisheyeFactor;
   

   • All cells are laid out depending on the largest font, so large differnce between the sizes of font and highlightedFont is NOT recommended.
   • fisheyeFactor property affects perspective distortion. The range is 0.0 - 1.0; slight value such as 0.0001 is recommended.

After all settings, never forget to reload your picker.

[self.pickerView reloadData];

For more detail, see the sample project.

Contact

@akkyie http://twitter.com/akkyie

License

See LICENSE.