Skip to content

aaaliua/AKPickerView

 
 

Repository files navigation

AKPickerView

Build Status

Screenshot Screenshot2

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.

About

A simple but customizable horizontal picker view.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Objective-C 95.9%
  • Ruby 3.1%
  • Makefile 1.0%