最新动态

有关详细更改,请参阅更新日志

概述

ProgressHUD 是一款专为 iOS 设计的便捷直观的 HUD 工具。它能够以简单且非侵入式的方式,无缝地向您的应用用户呈现简洁的警报或通知。

安装

‼️如果您使用的是 Xcode 14.3.1 或更早版本,请坚持使用13.8.6‼️

CocoaPods

CocoaPods 是 Swift 和 Objective-C Cocoa 项目的依赖管理工具。

要将 ProgressHUD 库整合到您使用 CocoaPods 的 Xcode 项目中,请在您的 Podfile 中如下引用它

pod 'ProgressHUD'

Swift Package Manager

Swift Package Manager 是一款用于管理 Swift 代码分发的工具。

要将 ProgressHUD 作为依赖项添加到您的项目中,请按照以下步骤操作

  1. 在 Xcode 中打开您的 Swift 项目。
  2. 导航至 File -> Add Package Dependencies...
  3. https://github.com/relatedcode/ProgressHUD.git 粘贴到搜索栏中。
  4. 选择您想要使用的版本,然后点击 Add Package

手动

如果您不想使用上述任何依赖管理器,您可以手动将 ProgressHUD 集成到您的项目中。只需将 ProgressHUD/Sources 文件夹中的所有 *.swift 文件复制到您的 Xcode 项目中即可。

快速开始

ProgressHUD.banner("Banner title", "Banner message to display.")
ProgressHUD.banner("Banner title", "Message to display.", delay: 2.0)
ProgressHUD.bannerHide()
ProgressHUD.animate("Some text...")
ProgressHUD.animate("Some text...", interaction: false)
ProgressHUD.animate("Please wait...", .ballVerticalBounce)
ProgressHUD.succeed()
ProgressHUD.succeed("Some text...", delay: 1.5)
ProgressHUD.failed()
ProgressHUD.failed("Some text...")
ProgressHUD.progress(0.15)
ProgressHUD.progress("Loading...", 0.42)
ProgressHUD.symbol(name: "box.truck")
ProgressHUD.symbol("Some text...", name: "sun.max")
ProgressHUD.dismiss()
ProgressHUD.remove()

要求

自定义

您可以使用以下方法自定义颜色、字体、图像、动画类型、大小等属性

ProgressHUD.animationType = .circleStrokeSpin
ProgressHUD.colorHUD = .systemGray
ProgressHUD.colorBackground = .lightGray
ProgressHUD.colorAnimation = .systemBlue
ProgressHUD.colorProgress = .systemBlue
ProgressHUD.colorStatus = .label
ProgressHUD.mediaSize = 100
ProgressHUD.marginSize = 50
ProgressHUD.fontStatus = .boldSystemFont(ofSize: 24)
ProgressHUD.imageSuccess = UIImage(named: "success.png")
ProgressHUD.imageError = UIImage(named: "error.png")

预定义枚举的完整列表

public enum AnimationType: CaseIterable {
	case none
	case activityIndicator
	case ballVerticalBounce
	case barSweepToggle
	case circleArcDotSpin
	case circleBarSpinFade
	case circleDotSpinFade
	case circlePulseMultiple
	case circlePulseSingle
	case circleRippleMultiple
	case circleRippleSingle
	case circleRotateChase
	case circleStrokeSpin
	case dualDotSidestep
	case horizontalBarScaling
	case horizontalDotScaling
	case pacmanProgress
	case quintupleDotDance
	case semiRingRotation
	case sfSymbolBounce
	case squareCircuitSnake
	case triangleDotShift
}
public enum LiveIcon {
	case succeed
	case failed
	case added
}

许可证

MIT 许可证

版权所有 (c) 2024 Related Code

特此授予任何人免费许可,以处理本软件和相关文档文件(“软件”),包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利,并允许向其提供软件的人员这样做,但须符合以下条件

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“原样”提供,不提供任何形式的明示或暗示保证,包括但不限于适销性、特定用途适用性和非侵权保证。在任何情况下,作者或版权持有人均不对任何索赔、损害或其他责任负责,无论是在合同诉讼、侵权诉讼或其他诉讼中,因本软件或本软件的使用或其他交易而引起、产生或与之相关的任何索赔、损害或其他责任负责。