SVProgressHUD: 简洁、高效、可定制的 iOS & macOS 进度提示框
项目地址:https://gitcode.com/gh_mirrors/sv/SVProgressHUD
SVProgressHUD 是一个轻量级的进度提示框库,适用于 iOS 和 macOS 平台。它提供了简洁易用的 API,可以让您轻松地在应用程序中显示加载指示器、成功或错误消息。
应用场景与功能特性
- 显示加载指示器:在数据请求、文件上传下载等耗时操作期间,可以展示加载圈或者菊花图标。
- 成功/错误提示:向用户展示操作结果(如保存成功、网络连接失败等),并自动消失。
- 可自定义外观:支持设置颜色、字体、透明度等属性以满足您的 UI 需求。
- 支持多个同时运行的任务:当有多个任务并发执行时,SVProgressHUD 能够正确处理它们的显示顺序和相互影响。
- 兼容 Swift 和 Objective-C:方便在各种项目中集成使用。
- 支持暗色模式:在启用暗色模式的设备上会自动调整配色。
快速开始与示例代码
要将 SVProgressHUD 集成到您的项目中,请参考以下步骤:
- 使用 CocoaPods 安装:
pod 'SVProgressHUD'
- 导入头文件并在需要的地方使用 SVProgressHUD:
import SVProgressHUD
// 显示加载指示器
SVProgressHUD.show()
// 显示带有信息的文字提示
SVProgressHUD.showMessage("正在加载...")
// 显示成功提示
SVProgressHUD.showSuccess(withStatus: "操作成功")
// 显示错误提示
SVProgressHUD.showError(withStatus: "操作失败")
// 结束显示所有提示
SVProgressHUD.dismiss()
- 自定义样式:
let config = SVProgressHUD.config
config.style = .custom
config.customView = UIView()
config.activityIndicatorViewStyle = .whiteLarge
config.statusLabel.textColor = .white
config.removeFromSuperViewOnHide = true
config.dimBackground = false
SVProgressHUD.set(config: config)
社区支持与资源
- 查看官方文档:https://github.com/SVProgressHUD/SVProgressHUD/blob/master/README.md
- 在 GitHub 上提出问题或提交 Pull Request:https://github.com/SVProgressHUD/SVProgressHUD
- 阅读完整的 API 文档:https://cocoapods.org/pods/SVProgressHUD
总之,SVProgressHUD 是一款优秀的进度提示框库,无论是在简单的加载指示还是复杂的情景需求下都能提供出色的表现。现在就尝试将其集成到您的 iOS 或 macOS 应用程序中,为用户提供更好的交互体验吧!