KVSpinnerView 1.0.1

KVSpinnerView 1.0.1

测试已测试
语言语言 SwiftSwift
许可证 MIT
发布时间上次发布2017年2月
SwiftSwift 版本3.0
SPM支持 SPM

KVSpinnerView 维护。



  • Vladislav Kuznetsov

KVSpinnerView

KVSpinnerView 是一个高度可自定义的进度 HUD,可以在执行某些工作时有显示信息或进度的能力。KVSpinnerView 有几种动画类型,这是使用 CAAnimations 编写的。

alt text alt text

安装

Cocoa Pods

使用 CocoaPods 是推荐您添加 KVSpinnerView 到您项目的方式

  1. 将以下行添加到您的 Podfile 中:pod 'KVSpinnerView', '~> 1.0'

  2. 关闭 .xcodeproj -> 打开终端 -> 打开项目目录 -> 运行 pod install

  3. 在需要的地方导入 KVSpinnerView(《import KVSpinnerView》)

手动安装

  1. 下载 最新代码版本

  2. KVSpinnerView 目录复制到您的项目中

用法

您可以在后台执行一些任务、加载一些大任务等时使用 KVSpinnerView 方法。要显示屏幕上的 KVSpinnerView,您应该使用其静态方法。

KVSpinnerView.show()
self.doSomeTask().response { (object) in
    DispatchQueue.main.async {
        KVSpinnerView.dismiss()
    }
}

同时,您还可以在显示 KVSpinnerView 时添加状态信息。根据信息宽度,KVSpinning 视图的背景矩形将自动扩展。

KVSpinnerView.show(saying: "Hello")

使用此方法在几秒后移除 SKSpinnerView。

KVSpinnerView.dismiss(after: 5.0)

向屏幕添加 KVSpinner 视图的两种方式

  1. 使用 KVSpinnerView.show() 方法将 spinner 添加到 UIApplication 的窗口。如果您使用此方法,则 spinner 将一直显示在屏幕上,直到您它消失。

  2. 使用 KVSpinnerView.show(on: _) 方法将 spinner 添加到您选择的视图,例如:

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        KVSpinnerView.show(on: self.view)
    }
}

自定义

此外,KVSpinnerView 也可以高度自定义。您可以通过更改 KVSpinnerView.settings 参数来自定义它,例如:

  • animationStyle - Spinner 的动画类型。目前有 2 种变体:standart(默认)和 infinite

  • spinnerRadius - KVSpinnerView 的半径。根据此参数,背景矩形改变其大小

  • linesWidth - 每条动画线的宽度

  • linesCount - KVSpinnerView 动画线的总计数

  • backgroundOpacity - 背景矩形的透明度

  • tintColor - 每条动画线的颜色

  • backgroundRectColor - 背景矩形的颜色

  • statusTextColor - 状态消息文本的颜色

  • minimumDismissDelay - KVSpinnerView不会被早于此参数(以秒为单位)移除

  • animationDuration - 动画线旋转持续时长

  • fadeInDuration - 背景矩形淡入持续时间

  • fadeOutDuration - 背景矩形淡出持续时间

屏幕截图

Purple Gray Purple

待办事项

  • 添加进度处理动画(例如:URLSession/Alamofire进度处理)
  • 添加几种动画类型
  • 添加带有状态消息的成功和错误动画

许可

本代码在MIT许可条款和条件下分发