一个可配置的图表,通过微妙的动画来展示测量值。
要手动安装,只需将CircleGaugeView
目录下的所有内容复制到您的Xcode项目中。
重要:如果您的项目不使用ARC,您必须在目标设置>编译步骤>编译源中添加-fobjc-arc
编译器标志到所有CircleGaugeView实现文件。
像其他视图一样实例化,并根据需要自定义。
- (void)viewDidAppear:(BOOL)animated {
[super viewDidAppear:animated];
CGRect frame = CGRectMake(0, 0, 200, 200);
CHCircleGaugeView *circleGaugeView = [[CHCircleGaugeView alloc] initWithFrame:frame];
[self.view addSubView:circleGaugeView];
[circleGauge setValue:0.5 animated:YES];
}
有一个state
属性,类型为CHCircleGaugeViewState
,它决定了如何显示一些内容。
CHCircleGaugeViewStateNA
:“n/a”显示在圈的中心,轨道内的量表将不会出现。显示的字符串可以通过设置量表上的notApplicableString
属性来更改。CHCircleGaugeViewStatePercentSign
:“%”显示在圈的中心,轨道内的量表将不会出现。可以通过设置量表上的noDataString
属性来更改显示的字符串。CHCircleGaugeViewStateScore
:显示一个整数(带可选的计量单位后缀)在圈的中心,轨道内的量表将代表该值。修改或设置value
属性会自动将状态切换到CHCircleGaugeViewStateScore
。
要更改量表值,您可以调用setValue:animated:
或设置value
。
可以通过调整公共属性轻松配置量表
trackTintColor
:始终填充的量表部分的显示颜色。gaugeTintColor
:在trackTintColor
之上的显示颜色,用于基于value
属性的量表部分。textColor
:文本颜色。font
:文本字体。trackWidth
:始终填充的量表部分的宽度。默认值为0.5。gaugeWidth
:基于value
属性的量表部分的宽度。默认值为2。unitsString
:是value
后缀的字符串。这个字符串意味着长度只有几个字符。默认为nil
。notApplicableString
:当仪表的状态为 CHCircleGaugeViewStateNA
时显示的文本。默认为 "n/a"。noDataString
:当仪表的状态为 CHCircleGaugeViewStatePercentSign
时显示的文本。默认为 "%"。gaugeStyle
:确定仪表相对于轨迹的绘制方式。默认为 CHCircleGaugeStyleInside
。欢迎拉取请求。为了添加功能或进行更改
CHCircleGuageViewExample
目录中打开 CHCircleGuageViewExample.xcworkspace
。CHCircleGaugeView
组中更改必要的文件。由 Osama Ashawa、Matthew Morey、Rogelio Gudino 和其他 贡献者 创建。
CHCircleGaugeView 在 MIT 许可下可用。有关更多信息,请参阅 LICENSE 文件。如果你在项目中使用 CHCircleGaugeView,那么署名将会很棒。