Skip to content
This repository has been archived by the owner on Dec 18, 2017. It is now read-only.

Latest commit

 

History

History
84 lines (63 loc) · 2.96 KB

README.md

File metadata and controls

84 lines (63 loc) · 2.96 KB

AKPickerView

Build Status Gitter

Screenshot

Screenshot

A simple yet customizable horizontal picker view.

Works on iOS 6, 7 and 8.

News: Say Good-Bye to Bridging-Header! The Swift version is here.

Installation

Use CocoaPods

pod "AKPickerView"

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

Usage

Caveat: From version 2.0, dataSource separated from delegate. When you updated it, check new how to use below.

  1. Instantiate and set delegate and dataSource as you know,

    self.pickerView = [[AKPickerView alloc] initWithFrame:<#frame#>];
    self.pickerView.delegate = self;
    self.pickerView.dataSource = self;
  2. then specify the number of items using AKPickerViewDataSource 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.
  5. After all settings, never forget to reload your picker.

    [self.pickerView reloadData];
  6. Optional: You can use AKPickerViewDelegate method to observe selection changes:

    - (void)pickerView:(AKPickerView *)pickerView didSelectItem:(NSInteger)item;

    Additionally, you can use UIScrollViewDelegate method to observe scrolling.

For more detail, see the sample project.

Contact

@akkyie http://twitter.com/akkyie

License

MIT. See LICENSE.