An extensible circular slider for iOS applications.
Demo
The code to make this GIF is in the
ExampleProject/
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"
You could instead clone the project and copy the EFCircularSlider/EFCircularSlider.{h,m} files into your project.
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];
...
}
And then, just like you would for any other control, you need to subscribe to the event chagning using target-action behavior:
[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
You can change the handleType with:
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];
Note this will have no effect if you have not passed in the labels that you want to add
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;
Note this will have no effect if you have not passed in the labels that you want to add
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];
Download: https://github.com/eliotfowler/EFCircularSlider/archive/master.zip