LiquidLoader 使用指南

LiquidLoader 使用指南

LiquidLoaderSpinner loader components with liquid animation项目地址:https://gitcode.com/gh_mirrors/li/LiquidLoader

---

项目介绍

LiquidLoader 是一个基于 Swift 开发的加载指示器组件，它以独特的液体动画效果脱颖而出。灵感源自流畅且吸引眼球的 Gooey light 效果，这个库提供了多种动画类型，包括 growCircle, growLine, circle, 和 line，让等待界面不再单调。适用于 iOS 应用，它可以无缝集成到你的项目中，为用户提供更加生动和有趣的加载体验。

项目快速启动

安装

使用 CocoaPods

在你的 Podfile 中添加以下行来安装 LiquidLoader：

pod 'LiquidLoader'

接着，在终端运行 pod install。

使用 Carthage

如果你更倾向于 Carthage，将以下行添加到你的 Cartfile 中：

github "yoavlt/LiquidLoader"

然后执行 carthage update.

基本使用

一旦安装完成，你可以这样在你的视图中显示一个 LiquidLoader：

import LiquidLoader

// 创建并配置 LiquidLoader
let loaderFrame = CGRect(x: 50, y: 100, width: 100, height: 100)
let loader = LiquidLoader(frame: loaderFrame, effect: .growCircle(circleColor: UIColor(red: 10/255.0, green: 1/255.0, blue: 0, alpha: 1), growColor: UIColor.red))
loader.view.backgroundColor = .clear // 确保背景透明（如果需要）
view.addSubview(loader)

// 显示加载器
loader.show()

// 隐藏加载器，当操作完成时调用
// loader.hide()

应用案例与最佳实践

在实际应用中，LiquidLoader 可以在数据请求、页面加载或任何可能导致用户等待的操作时展示。最佳实践是确保在异步操作开始前立即调用 show() 方法，并在操作成功或失败后调用 hide() 方法，以提供一致的用户体验。

例如，当发起网络请求时，你可以在请求开始前显示 LiquidLoader，并在回调中隐藏它：

func fetchData() {
    loader.show()
    
    // 发起网络请求...
    
    URLSession.shared.dataTask(with: request) { data, response, error in
        DispatchQueue.main.async {
            // 处理数据或错误
            // ...
            
            // 请求完成，无论成功还是失败都隐藏加载器
            self.loader.hide()
        }
    }.resume()
}

典型生态项目

虽然 LiquidLoader 主要作为一个独立的加载指示器存在，但它可以很容易地与其他 UI 组件和框架结合使用，如 SwiftUI 或 Combine，以增强现代iOS开发中的响应式编程体验。开发者可以通过封装 LiquidLoader 到自定义视图或利用 Combine 的发布者来同步加载状态，实现更复杂的交互逻辑和界面反馈机制。

---

此文档为 LiquidLoader 的基础使用说明，更深入的定制选项和高级用法，请参考项目 README.md 文件及源码注释获取更多信息。

LiquidLoaderSpinner loader components with liquid animation项目地址:https://gitcode.com/gh_mirrors/li/LiquidLoader