CocoaPods trunk is moving to be read-only. Read more on the blog, there are 17 months to go.

MTTCircularSlider 1.1.0

MTTCircularSlider 1.1.0

TestsTested
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Mar 2016

Maintained by MTT.



  • By
  • MTT

MTTCircularSlider 是一个IOS平台上的圆形滑杆控件

(Dome)

安装

MTTCircularSlider 支持 CocoaPods.你可以在你项目中的Podfile文件内添加以下代码添加MTTCircularSlider:

pod 'MTTCircularSlider'

使用

/MTTCircularSliderDome内写有比较详细的Dome,可直接查看代码

默认样式

MTTCircularSlider* slider = [[MTTCircularSlider alloc] initWithFrame:CGRectMake(100, 100, 150, 150)];
[self.view addSubview:slider];

你还可以通过设置以下参数修改UI

@property (nonatomic) CGFloat lineWidth;//圆环宽度
@property (nonatomic, strong) UIColor* selectColor;//选中部分颜色
@property (nonatomic, strong) UIColor* unselectColor;//未选中部分颜色
@property (nonatomic, strong) UIColor* indicatorColor;//指示器颜色
@property (nonatomic) CGFloat contextPadding;//内边距

自定义图片样式

Dome

slider.sliderStyle = MTTCircularSliderStyleImage;
slider.unselectImage = [UIImage imageNamed:@"unselect.png"];
slider.selectImage = [UIImage imageNamed:@"select.png"];
slider.indicatorImage = [UIImage imageNamed:@"indicator.png"];

图片素材参考,图片的大小建议一样

unselectImage selectImage indicatorImage

事件

你可以添加UIControlEventValueChanged事件,在用户改变角度时触发事件

[slider addTarget:self action:@selector(sliderValueChanged:) forControlEvents:UIControlEventValueChanged];

你也可以添加UIControlEventEditingDidEnd事件,在用户操作结束时触发事件

[slider addTarget:self action:@selector(sliderEditingDidEnd:) forControlEvents:UIControlEventEditingDidEnd;

参数

sliderStyle:(MTTCircularSliderStyle)

默认值:MTTCircularSliderStyleDefault,用于设置控件样式.

MTTCircularSlider目前有以下3个样式

  • MTTCircularSliderStyleDefault = 1, //默认样式
  • MTTCircularSliderStyleImage = 2, //自定义图片样式
  • MTTCircularSliderStyleNone = 0, //无样式
@property (nonatomic) MTTCircularSliderStyle sliderStyle;

circulate:(BOOL)

默认值:NO,设置圆环是否连通循环滑动

@property (nonatomic, getter=isCirculate) BOOL circulate;

MTTCircularSliderStyleDefault

以下参数仅在MTTCircularSliderStyleDefault样式下生效

/**
 *  圆圈宽度,默认:20
 */
@property (nonatomic) CGFloat lineWidth;
/**
 *  已选中进度颜色,默认:red:0.04 green:0.41 blue:1
 */
@property (nonatomic, strong) UIColor* selectColor;
/**
 *  未选中进度颜色,默认:red:0.71 green:0.71 blue:0.71
 */
@property (nonatomic, strong) UIColor* unselectColor;
/**
 *  指示器颜色,默认:whiteColor
 */
@property (nonatomic, strong) UIColor* indicatorColor;
/**
 *  内边距,默认:10
 */
@property (nonatomic) CGFloat contextPadding;

MTTCircularSliderStyleImage

以下参数仅在MTTCircularSliderStyleImage样式下生效

/**
 *  已选中进度图片
 */
@property (nonatomic, strong) UIImage* selectImage;
/**
 *  已选中进度图片
 */
@property (nonatomic, strong) UIImage* unselectImage;
/**
 *  指示器图片
 */
@property (nonatomic, strong) UIImage* indicatorImage;

Angle

可以设置以下参数对角度进行操作

/**
 *  当前角度,默认:0
 */
@property (nonatomic) NSInteger angle;
/**
 *  最大角度,默认:360
 */
@property (nonatomic) NSInteger maxAngle;
/**
 *  最小角度,默认:0
 */
@property (nonatomic) NSInteger minAngle;

Value

可以设置以下参数对Value进行操作

/**
 *  当前数值,默认:0
 */
@property (nonatomic) CGFloat value;
/**
 *  最小数值,默认:0
 */
@property (nonatomic) CGFloat minValue;
/**
 *  最大数值,默认:1
 */
@property (nonatomic) CGFloat maxValue;

License

MIT