Demo
The code to make this GIF is in theExampleProject/
directory:Installation
The simplest way to use EFCircularSlider in your application is with CocoaPods. See the "Getting Started" guide for more information.Podfile
platform :ios, '7.0'
pod "EFCircularSlider", "~> 0.1.0"
Initialization
Adding EFCircularSlider to your project is as simple as getting the source files, and waving a magic wand:- (void)viewDidLoad {
...
CGRect sliderFrame = CGRectMake(110, 150, 100, 100);
EFCircularSlider* circularSlider = [[EFCircularSlider alloc] initWithFrame:sliderFrame];
[self.view addSubview:circularSlider];
...
}
[slider addTarget:self action:@selector(newValue:) forControlEvents:UIControlEventValueChanged];
Options
EFCircularSlider is made to be very easy to style and customize.Properties
minimumValue:(float) - Default: 0.0f
When the slider is at the very top position, it will set the currentValue to this.You can set the minimum value with:
circularSlider.minimumValue = 1.0f;
maximumValue:(float) - Default 100.0f
With EFCircularSlider, the currentValue increases as you drag the slider clockwise. Therefore, when the slider is just to the left of the very top position, it will approach (but never reach) this.You can set the maximum value with:
circularSlider.minimumValue = 100.0f;
currentValue:(float) - Default 0.0f
Whenever the slider changes position, this value will change. It will be a normalized value based on the minimuimValue and maximumValue properties.You can get the currentValue with:
float val = circularSlider.currentValue;
lineWidth:(int) - Default 5
This determines the width of the arc that makes up the slider. This will set the value both for the unfilled arc (the background) and the arc that shows how much of the slider has been slid across. Currently, changing the lineWidth more than a few pixels causes adverse side effects, mainly with the handle.You can modify the lineWidth with:
circularSlider.lineWidth = 6;
handleColor:(UIColor*) - Default [UIColor redColor]
The handle is the part of the slider that you drag with your finger.Modify the color of the handle with:
CGFloat hue = ( arc4random() % 256 / 256.0 );
CGFloat saturation = ( arc4random() % 128 / 256.0 ) + 0.5;
CGFloat brightness = ( arc4random() % 128 / 256.0 ) + 0.5;
circularSlider.handleColor = [UIColor colorWithHue:hue saturation:saturation brightness:brightness alpha:1];
handleType:(EFHandleType) - Default EFSemiTransparentWhiteCircle
EFCircularSlider comes with 4 types of handles:- EFSemiTransparentWhiteCircle
- EFSemiTransparentBlackCircle
- EFDoubleCircleWithOpenCenter
- EFDoubleCircleWithClosedCenter
- EFBigCircle
circularSlider.handleType = EFDoubleCircleWithClosedCenter;
unfilledColor:(UIColor*) - Default [UIColor blackColor]
This is the color that will show if the slider is set to its minimum value.You can modify the unfilledColor with:
circularSlider.unfilledColor = [UIColor purpleColor];
filledColor:(UIColor*) - Default [UIColor redColor]
This is the color that will show between the minimum value and the currentValue.You can modify the filledColor with:
circularSlider.unfilledColor = [UIColor purpleColor];
labelFont:(UIFont*) - Default [UIFont systemFontOfSize:10.0f]
This is the font that the labels will have if you decide to set inner marking labels (more on this down the page).You can modify the labelFont with:
circularSlider.labelFont = [UIFont systemFontOfSize:14.0f];
snapToLabels:(BOOL) - Default NO
If this is set to YES, once finish dragging the slider, it will snap to the closest label and subsequently set the current value to what it would be at that label, not where you dragged it.You can set the slider to snap to labels with:
circularSlider.snapToLabels = YES;
Functions
-(void)setInnerMarkingLabels:(NSArray*)labels
You can send this method an array of labels and they will show up on the inside of the slider. There is currently no way to specify the spacing between the labels and therefore they will be evenly spaced out. If you choose to include labels on your slider, you will then have the option to set the font of the label as well as if the slider should snap to the closest label position after the value changes.The first label will appear at the 1 o'clock position (if it were a clock).
If you wanted to make your slider look like a clock, you would do the following:
NSArray* hoursArray = @[@"1", @"2", @"3", @"4", @"5", @"6", @"7", @"8", @"9", @"10", @"11", @"12"];
[circularSlider setInnerMarkingLabels:hoursArray];
No comments:
Post a Comment