YRActivityIndicator 1.3.0

YRActivityIndicator 1.3.0

Yuri Romanchenko 维护。



  • By
  • Yurii Romanchenko

YRActivityIndicator

YRActivityIndicator 是一个简单、高度可定制的轻量级组件,用于在您的应用程序中显示加载活动。

描述

YRActivityIndicator - 在您的应用程序中显示加载活动的组件。动画由旋转圆周上固定时间间隔旋转的项目组成。项目的尺寸在 maxItemSizeminItemSize 之间线性插值。每个项目都有它自己的旋转速度值,告诉它将如何快速完成从 0..2PI 的完整旋转周期。这个值由通过设置 maxSpeed 属性指定,并在项目之间线性插值。第一个项目获得最大速度,最后一个项目获得常规速度(1.0)。旋转角度通过使用三次贝塞尔曲线进行插值。

演示

使用默认设置的 YRActivityIndicator

Demo

自定义演示

FullDemo

请查看 YouTube 上的完整视频

安装

手册

只需将源内容拖放到项目中。

CocoaPods

YRActivityIndicator 可以通过 CocoaPods 获得。要安装它,只需将以下行添加到您的 Podfile

pod 'YRActivityIndicator'

使用

  1. 创建一个普通视图并将其类设置为 YRActivityIndicator
  2. 在应显示加载活动的类中创建一个与之相连的出口。
  3. 在显示之前自定义您想要的任何属性。
  4. YRActivityIndicator 对象上调用 -(void)startAnimating
  5. 当您需要停止动画时,调用 -(void)stopAnimating

自定义

您可以在任何时间自定义这些属性,即使在动画进行时。此外,您还可以通过使用用户定义的运行时属性直接在 xib/storyboard 中自定义 YRActivityIndicator:请参阅RuntimeAttributes

此外,YRActivityIndicator 支持在界面构建器中实时渲染:LiveRendering

将围绕想象中的圆形转动的项目总数。

@property (nonatomic) int32_t maxItems;

项目围绕旋转的想象中的圆形的半径。

@property (nonatomic) int32_t radius;

描述绕圆圈旋转所需的时间。

@property (nonatomic) NSTimeInterval cycleDuration;

项目最小/最大尺寸。通常,项目尺寸从第一个到第二个线性插值,所以第一个项目会有 maxItemSize,最后一个项目会有 minItemSize

@property (nonatomic) CGSize minItemSize;

@property (nonatomic) CGSize maxItemSize;

说明物品绕圆形完成一圈的速度提升情况。该值在物品之间进行线性插值。第一个物品将获得maxSpeed,最后一个物品将获得minSpeedminSpeed始终等于1)。

@property (nonatomic) CGFloat maxSpeed;

所有物品都绕着虚拟圆进行旋转,因此它们依赖于角度。旋转角度通过使用三次贝塞尔曲线进行插值。三次贝塞尔曲线有4个控制点来配置曲线(更多信息请点击这里)。组件(初始、最终)保留了2个曲线,它们分别等于(0, 0)和(1, 1)。另外两个可以由您自定义。例如,您可以使用这个网站调整您的曲线/抓取控制点,并将它们设置为活动指示器。

@property (nonatomic) CGPoint firstBezierControlPoint;

@property (nonatomic) CGPoint secondBezierControlPoint;

当活动指示器未在动画时,如果此属性设置为YES

@property (nonatomic) BOOL hidesWhenStopped;

您可以为正在旋转的物品提供自定义图片。《itemImage》具有比《itemColor》更高的优先级,因此当组件有图片时设置颜色不会改变任何内容。

@property (nonatomic) UIImage *itemImage;

将动画的物品颜色。

@property (nonatomic) UIColor *itemColor;

简单地说明当前活动指示器是否正在动画。

@property (nonatomic, readonly) BOOL isAnimating;

说明

如果您有任何建议,请随时联系我。

版本

v1.3.0

许可证

YRActivityIndicator遵循MIT许可证发布。请参阅LICENSE以获取详细信息。