CircleGaugeView 1.1.0

CircleGaugeView 1.1.0

测试已测试
Lang语言 Obj-CObjective C
许可证 MIT
发布上次发布2014 年 12 月

Matthew Morey 维护。




  • Matthew Morey,Rogelio Gudino和Osama Ashawa

一个可配置的图表,通过微妙的动画来展示测量值。

安装

手动安装

要手动安装,只需将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

贡献

欢迎拉取请求。为了添加功能或进行更改

  1. fork 此仓库。
  2. CHCircleGuageViewExample 目录中打开 CHCircleGuageViewExample.xcworkspace
  3. CHCircleGaugeView 组中更改必要的文件。
  4. 确保记录新的公共方法。
  5. 提交拉取请求。

作者

由 Osama Ashawa、Matthew Morey、Rogelio Gudino 和其他 贡献者 创建。

许可

CHCircleGaugeView 在 MIT 许可下可用。有关更多信息,请参阅 LICENSE 文件。如果你在项目中使用 CHCircleGaugeView,那么署名将会很棒。