MMPickerView 0.0.1

MMPickerView 0.0.1

TestsTested
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Dec 2014

Maintained by Unclaimed.


Downloads

Total14,143
Week0
Month353

Installs

Apps533
Test Targets27
Watch Apps2
powered by Segment

GitHub

Stars236
Watchers11
Forks68
Issues16
Contributors1
Pull Requests8

Code

Files2
LOCLines of Code 249



  • By
  • Madjid Mahdjoubi

An easy to use and customizable PickerView for your iOS app. With animation, design options, selected value and previously selected value functionality. Works with iOS 6 and even better in iOS 7, because it let's you change the background color of the PickerView.


MMPickerView Images to the left: iOS 6. Images to the right: iOS 7.


Installation

Manually

Important note if your project doesn't use ARC: you must add the -fobjc-arc compiler flag to MMPickerView.m in Target Settings > Build Phases > Compile Sources.

  • Drag the MMPickerView/MMPickerView folder into your project.
  • Make sure you have the CoreGraphics framework in your project.

Usage

(see sample Xcode project in /Demo)

MMPickerView is created as a singleton (i.e. it doesn't need to be explicitly allocated and instantiated; you directly call [MMPickerView method]).

Showing the PickerView

You can show the PickerView:

+(void)showPickerViewInView: (UIView *)view
                withStrings: (NSArray *)strings
                withOptions: (NSDictionary *)options
                 completion: (void(^)(NSString *selectedString))completion;

+(void)showPickerViewInView: (UIView *)view
                withObjetcs: (NSArray *)objects
                withOptions: (NSDictionary *)options
    objectToStringConverter: (NSString *(^)(id object))converter
                 completion: (void(^)(id selectedObject))completion;

Example 1 - Show with an array of strings.

  NSArray *strings = @[@"This", @"is", @"just", @"an array", @"of strings."];

  [MMPickerView showPickerViewInView:self.view
                         withStrings:strings
                         withOptions:nil
                          completion:^(NSString *selectedString) {
                            //selectedString is the return value which you can use as you wish
                            self.label.text = selectedString;
  }];

Example 2 - Show with an array of objects.

  NSArray *objects = @[@"This is a mix of objects", @14, @13.3, @"A string", @1000];

  [MMPickerView showPickerViewInView:self.view
                         withObjects:objects
                         withOptions:nil
            objectToStringConverter:^NSString *(id object) {
            //This is where you convert your object and return a string, for eg. return person.name;
              return [object description];

              }
                         completion:^(id selectedObject) {
                         //The selected object is returned, and you can use the value as you wish
                         //For example: self.label.text = person.name;
                         self.label.text = [selectedObject description];
  }];

Customizing MMPickerView

Both show methods use a NSDictionary to set the options of the MMPickerView. If you want a native looking PickerView, just withOptions: nil. In case of customization, use any of the different properties to customize the PickerView. All of the properties are optional, which means that if you only want to change one thing, like for eg the text color you can do like this, withOptions: @{MMtextColor: [UIColor redColor]}

Options

  • MMbackgroundColor - UIColor
  • MMtextColor - UIColor
  • MMtoolbarBackgroundColor - UIColor
  • MMbuttonColor - UIColor
  • MMfont - UIFont
  • MMValueY - NSInteger
  • MMselectedObject - id
  • MMtoolbarBackgroundImage - UIImage

Example 3 - Show with an array of strings and with custom colors and custom font.

 /*
  Options:
  MMbackgroundColor - UIColor - The background color of the PickerView (>=iOS 7)
  MMtextColor - UIColor - The text color of the PickerView
  MMtoolbarBackgroundColor - UIColor - The background color of the toolbar
  MMbuttonColor - UIColor - The background color (<= iOS 6) or text color (>=iOS 7) of the Done button
  MMfont - UIFont - The font of the PickerView labels
  MMValueY - NSInteger - The Y value from the top of every label in the PickerView, useful when changing font/font-size.
  MMselectedObject - id - The selected object presented in the PickerView, an object from the array, for eg. [yourArray objectAtIndex:0];
  MMtoolbarBackgroundImage - UIImage - The background image of the toolbar (320 x 44 for non retina, 640 x 88 for retina)
 */

  NSArray *strings = @[@"This", @"is", @"just", @"an array", @"of strings."];
  UIFont *customFont  = [UIFont fontWithName:@"Palatino-Bold" size:19.0];
  NSDictionary *options = @{MMbackgroundColor: [UIColor blackColor],
                                  MMtextColor: [UIColor whiteColor],
                               MMtoolbarColor: [UIColor darkGrayColor],
                                MMbuttonColor: [UIColor whiteColor],
                                       MMfont: customFont,
                                     MMValueY: @5};


  [MMPickerView showPickerViewInView:self.view
                         withStrings:strings
                         withOptions:options
                          completion:^(NSString *selectedString) {
                            //selectedString is the return value which you can use as you wish
                            self.label.text = selectedString;
                          }];

Selected Value

A useful feature is to let the PickerView select whatever was selected last time. This can easily be done with both show methods, as shown in the Example 4.

Example 4 - Show with an array of strings set selectedValue on PickerView.

@interface ViewController ()

@property (nonatomic, strong) NSString * selectedString;

@end


@implementation ViewController

- (void)viewDidLoad
{
    [super viewDidLoad];

  self.selectedString = [_stringsArray objectAtIndex:0];

}



- (IBAction)showPickerViewButtonPressed:(id)sender {


  NSArray *strings = @[@"This", @"is", @"just", @"an array", @"of strings."];
  [MMPickerView showPickerViewInView:self.view
                         withStrings:strings
                         withOptions:@{selectedObject:_selectedString}
                          completion:^(NSString *selectedString) {

                            _label.text = selectedString;
                            _selectedString = selectedString;
  }];

}

@end  

Credits

MMPickerView is brought to you by Madjid Mahdjoubi. If you have feature suggestions or bug reports, feel free to help out by sending pull requests or by creating new issues. If you're using MMPickerView in your project, attribution would be nice.