WisdomHUD intro

1. 'WisdomHUD' Is a HUD frame indicator SDK that supports a variety of styles.

2. 'WisdomHUD' The system supports at least iOS 9.0, Swift 5.5, 5.6, and 5.7, and is compatible with OC class calls.

3. 'WisdomHUD' supports dynamic adjustment of the internal properties of the global/single-point HUD, and supports the setting of the view focus display.

4. 'WisdomHUD' support timeout/delay time setting, support timeout/delay end event callback processing.

5. 'WisdomHUD' supports multiple Loading/Progress load style, and succes/error/warning/text prompt style, allows you to set tip animation.

6. 'WisdomHUD' icon is realized by drawing, and icon cache is added to avoid the repetitive drawing task, which is also the only way for HUD SDK to achieve high performance.

7. 'WisdomHUD' if made into a static library use, because there is no resource file, do not need to consider the resource loading, to ensure security.

8. 'WisdomHUD' API call convenient/flexible, later will update iteration, recommended use.

9. `WisdomHUD` Support control multiple attributes (text size/text color/text content) dynamic update.

10. `WisdomHUD` Support HUD center animation control view Settings, custom replacement.

11. `WisdomHUD` You can view log information and print it out on a unique interface。

WisdomHUD 简介

1. `WisdomHUD` 是一款支持多种样式的 HUD 弹框指示器 SDK。

2. `WisdomHUD` 系统最低支持 iOS 9.0版本，支持 Swift 5.5，5.6，5.7 版本，兼容 OC 类调用使用。

3. `WisdomHUD` 支持 全局/单点 HUD 内部属性动态 调整，支持视图 聚焦显示设置。

4. `WisdomHUD` 支持 超时/延迟 时间设置，支持 超时/延迟 结束事件回调处理。

5. `WisdomHUD` 支持多种 Loading/Progress/Action 加载样式，和 succes/error/warning/text 提示样式，支持设置提示动画。

6. `WisdomHUD` 图标通过 绘制实现，且加入了 图标缓存，避让了重复绘制任务，也是 HUD SDK 高性能必经之路。

7. `WisdomHUD` 如果制作成静态库使用，因没有资源文件，不需要考虑资源加载，保证了安全。

8. `WisdomHUD` API 调用方便/灵活，后期会更新迭代，推荐使用。

9. `WisdomHUD` 支持控件多属性（文字大小/文字颜色/文字内容）动态更新。

10. `WisdomHUD` 支持 HUD 中心动画控件视图设置，自定义替换。

11. `WisdomHUD` 支持输出日志信息查看，并在独有的界面打印显示。

Swift and Cocoapods

1. address： https://github.com/tangjianfengVS/WisdomHUD

2. Swift Version Support： 5.5, 5.6, 5.7

3. cocoapods 集成：pod 'WisdomHUD', '0.3.5'

WisdomHUD Icom

WisdomHUD how to ues

(1)：WisdomHUD的所有样式支持 (Style support)：

/* HUD Style */
public enum WisdomHUDStyle: CaseIterable {

  case succes   // image + text

  case error    // image + text

  case warning  // image + text

  case loading  // image + text
    
  case progress // image + text

  case text     // text
}

(2)：WisdomHUD的 Loading 加载样式支持 (Loading Style support)：

/* HUD Loading Style */
@objc public enum WisdomLoadingStyle: NSInteger, CaseIterable {

  case system=0     // 系统菊花 (System chrysanthemum)

  case rotate       // 经典旋圈 (Classical rotation)

  case progressArc  // 缩进弧   (Arc of retract)

  case tadpoleArc   // 蝌蚪弧   (Tadpole arc)

  case chaseBall    // 追逐球   (Chasing the ball)

  case pulseBall    // 脉冲球   (Pulse ball)

  case pulseShape   // 脉冲形状  (Pulse shape)
}

(3)：WisdomHUD的 Progress 加载样式支持 (Progress Style support)：

/* HUD Progress Style */
@objc public enum WisdomProgressStyle: NSInteger, CaseIterable {

  case circle=0  // 中心圆  (Central circle)
  
  case linear    // 线型  (linetype)
  
  case water     // 水球  (Water polo)
}

(4)：WisdomHUD的 BarStyle 背景样式支持 (Backdrop Style support)：

/* HUD Scene Bar Style */
@objc public enum WisdomSceneBarStyle: NSInteger, CaseIterable {

  case dark=0    // 黑色

  case light     // 白色

  case hide      // 隐藏
}

(5)：WisdomHUD的 TextPlace 位置样式支持 (Position Style support)：

/* HUD Text Place Style */
@objc public enum WisdomTextPlaceStyle: NSInteger, CaseIterable {

  case center=0  // 中心

  case bottom    // 底部
}

(6)：WisdomHUD的 Context Info 信息调整 (Information adjustment)：

/* HUD Text Context Set Info */
@objc public protocol WisdomHUDBaseContextable {

  // 文字大小调整 (Text resizing)
  @discardableResult
  @objc func setTextFont(font: UIFont)->Self

  // 文字颜色调整 (Text color adjustment)
  @discardableResult
  @objc func setTextColor(color: UIColor)->Self

  // 文字内容更新 (Text content update)
  @discardableResult
  @objc func setUpdateText(text: String)->Self

  // 动画视图自定义 (Animation view custom)
  @discardableResult
  @objc func setAnimation(view: UIView)->Self
}

(7)：WisdomHUD的 Context Focusing 聚焦设置（去除遮盖视图，允许底部试图交互，Loading HUD不支持）：

note：Focus setting (removes masking view, allows bottom attempt interaction, Loading HUD not supported)
 
/* HUD Text Context Set Focusing */
@objc public protocol WisdomHUDContextable: WisdomHUDBaseContextable {

  @discardableResult
  @objc func setFocusing()->Self
}

(8)：WisdomHUD的 Loading Context Timeout 超时设置（超时时间到了 Loading HUD 回调结束，并自动移除）：

note：Timeout setting (The timeout is automatically removed after the Loading HUD callback ends)

/* HUD Text Context Set Loading Timeout */
@objc public protocol WisdomHUDLoadingContextable: WisdomHUDBaseContextable {

  @discardableResult
  @objc func setTimeout(time: TimeInterval, timeoutClosure: @escaping ((TimeInterval)->()))->Self
}

(9)：WisdomHUD的全局属性设置 (Global property setting)：

/* HUD Setting able */
extension WisdomHUD: WisdomHUDSettingable {

  // MARK: HUD Set Loading Style 加载样式
  @objc public static func setLoadingStyle(loadingStyle: WisdomLoadingStyle)

  // MARK: HUD Set Scene Bar Style bar颜色
  @objc public static func setSceneBarStyle(sceneBarStyle: WisdomSceneBarStyle)

  // MARK: HUD Set Display Delay 显示时长
  @objc public static func setDisplayDelay(delayTime: CGFloat)

  // MARK: HUD Set Cover BackgColor 背景颜色
  @objc public static func setCoverBackgColor(backgColor: UIColor)
}

(10)：WisdomHUD的弹框使用案例 (Pop-up use cases)：

let style: WisdomHUDStyle = WisdomHUDStyle.allCases[indexPath.section]
switch style {
case .succes:  // 成功样式：延迟时间设置

    WisdomHUD.showSuccess(text: "加载成功", barStyle: sceneBarStyle, inSupView: view, delays: 3) { interval in
        print("3秒显示结束")
    } 
case .error:  // 失败样式：延迟时间设置/指定视图添加/设置聚焦/设置文字颜色和大小

    WisdomHUD.showError(text: "加载失败", barStyle: sceneBarStyle, inSupView: view, delays: 3) { interval in
        print("3秒显示结束")
    }.setFocusing().setTextColor(color: .red).setTextFont(font: UIFont.boldSystemFont(ofSize: 14))
    
case .warning: // 警告样式：延迟时间设置/指定视图添加/设置聚焦

    WisdomHUD.showWarning(text: "加载警告", barStyle: sceneBarStyle, inSupView: view, delays: 3) { interval in
        print("3秒显示结束")
    }.setFocusing()
    
case .loading: // 加载样式：异步加载/超时时间设置

    if let loadingStyle = WisdomLoadingStyle(rawValue: indexPath.row) {
        DispatchQueue.global().async {
                
            WisdomHUD.showLoading(text: "正在加载中",
                                  loadingStyle: loadingStyle,
                                  barStyle: sceneBarStyle).setTimeout(time: 8) { _ in
                    
                WisdomHUD.showTextBottom(text: "加载超时，稍后重试",
                                             barStyle: sceneBarStyle,
                                             delays: 5, delayClosure: nil).setFocusing()
            }
        }
    }
case .text: // 文字样式

    switch WisdomTextPlaceStyle.allCases[indexPath.row] {
    case .center: // 中心文字样式：延迟时间设置/指定视图添加/设置聚焦/设置文字颜色和大小
    
        WisdomHUD.showTextCenter(text: "inSupView 添加失败，请稍后重试", barStyle: sceneBarStyle, inSupView: view, delays: 3) { interval in
            print("3秒显示结束")
        }.setFocusing().setTextColor(color: .blue).setTextFont(font: UIFont.boldSystemFont(ofSize: 14))
            
    case .bottom: // 底部文字样式：延迟时间设置/指定视图添加/设置聚焦
    
        WisdomHUD.showTextBottom(text: "inSupView 添加失败，请稍后重试,添加失败，请稍后重试,添加失败，请稍后重试,添加失败，请稍后重试",
                                 barStyle: sceneBarStyle,
                                 inSupView: view,
                                 delays: 3) { interval in     
            print("3秒显示结束")
        }.setFocusing()
        
    default: break
    }
    
// note：Progress style: Set progress color/Set progress text color/Set progress value/Complete removal
case .progress: // 进度样式：设置进度颜色/设置进度文字颜色/设置进度值/完成移除

    let contextable = WisdomHUD.showProgress(text: "上传文件").setProgressColor(color: .systemPink).setProgressTextColor(color: .systemPink)
    let list: [UInt] = [1,2,3,4,5,6,7,8,9,10]
    for item in list {
        DispatchQueue.main.asyncAfter(deadline: DispatchTime.now()+TimeInterval(item)) {
        
            contextable.setProgressValue(value: item*10)
            
            if item*10 >= 100 {
                DispatchQueue.main.asyncAfter(deadline: DispatchTime.now()+5) {
                    WisdomHUD.dismiss()
                }
            }
        }
    }
}

(11)：WisdomHUD的日志信息界面打印使用 (Log information is printed and used on the interface)：

extension WisdomHUD: WisdomHUDLogable {

    // MARK: Debug Open Log 
    @objc public static func openLog() 

    // MARK: Debug Show Log with: String
    @objc public static func showLog(text: String)

    // MARK: Debug Show Log Success with: String ✅
    @objc public static func showLogSuccess(text: String) 

    // MARK: Debug Show Log Warning with: String ⚠️
    @objc public static func showLogWarning(text: String) 

    // MARK: Debug Show Log Error with: String 🚫
    @objc public static func showLogError(text: String) 

    // MARK: Debug Show Log Label with: String ♥️
    @objc public static func showLogLabel(text: String)
}

// Use case 
// note：You must set the information log page in advance before displaying it 'WisdomHUD.openLog()'
WisdomHUD.openLog() // 需要展示信息日志界面，必须要提前设置 'WisdomHUD.openLog()'

WisdomHUD.showLogSuccess(text: "Success")

WisdomHUD.showLogWarning(text: "Warning")

WisdomHUD.showLogError(text: "Error")

WisdomHUD.showLogLabel(text: "Label")

WisdomHUD star

喜欢的朋友，觉得 SDK 写的还不错的朋友，请帮忙推荐给身边的小伙伴们，给颗星，十分感谢！ Like friends, feel that the SDK writing is good friends, please help recommend to the small partners around, to the star, thank you very much!

如果您热衷于iOS/swift开发，是一位热爱学习进步的童鞋，欢迎来一起研究/讨论开发中遇到的问题。联系QQ：497609288。请给予我支持，我会继续我的创作。 If you are keen on iOS/swift development, you are a child who loves learning and progress, welcome to study/discuss the problems encountered in the development together. Contact QQ: 497609288. Please give me your support and I will continue my creation.

tangjianfengVS / WisdomHUD