YRActivityIndicator
YRActivityIndicator
是一个简单、高度可定制的轻量级组件,用于在您的应用程序中显示加载活动。
描述
YRActivityIndicator
- 在您的应用程序中显示加载活动的组件。动画由旋转圆周上固定时间间隔旋转的项目组成。项目的尺寸在 maxItemSize
和 minItemSize
之间线性插值。每个项目都有它自己的旋转速度值,告诉它将如何快速完成从 0..2PI 的完整旋转周期。这个值由通过设置 maxSpeed
属性指定,并在项目之间线性插值。第一个项目获得最大速度,最后一个项目获得常规速度(1.0)。旋转角度通过使用三次贝塞尔曲线进行插值。
演示
使用默认设置的 YRActivityIndicator
自定义演示
安装
手册
只需将源内容拖放到项目中。
CocoaPods
YRActivityIndicator 可以通过 CocoaPods 获得。要安装它,只需将以下行添加到您的 Podfile
pod 'YRActivityIndicator'
使用
- 创建一个普通视图并将其类设置为
YRActivityIndicator
。 - 在应显示加载活动的类中创建一个与之相连的出口。
- 在显示之前自定义您想要的任何属性。
- 在
YRActivityIndicator
对象上调用-(void)startAnimating
。 - 当您需要停止动画时,调用
-(void)stopAnimating
。
自定义
您可以在任何时间自定义这些属性,即使在动画进行时。此外,您还可以通过使用用户定义的运行时属性直接在 xib/storyboard 中自定义 YRActivityIndicator
:请参阅
此外,YRActivityIndicator
支持在界面构建器中实时渲染:
将围绕想象中的圆形转动的项目总数。
@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
,最后一个物品将获得minSpeed
(minSpeed
始终等于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以获取详细信息。