Toast For Swift

概要说明

MCToast 是Swift版本的HUD库，提供了显示纯文本的Toast，带有状态图片的Toast，带有loading样式的Toast。

Toast.gif

主要优点：

• Swift语言实现的Toast交互功能库。
• MCToast内部控制显示在主线程中，保证了线程安全性。
• 提供了多种使用方式，方便快捷。
• 支持UI的高度自定义。配置toast的小图标，文字大小和颜色等
• 内部处理了多个toast提示重叠显示的问题。

Demo地址

https://github.com/mancongiOS/MCToast

配置

MCToast已经提供了一套默认值，如果与您的要求不相符，您完全可以根据以下方法通配它。

在func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool中进行配置项的设置。

extension AppDelegate {
    func configToast() {
        // 1. 配置Toast弹出过程中的交互类型（MCToastRespond：禁止交互，导航栏下禁止交互，允许交互）
        MCToastConfig.shared.respond = MCToast.MCToastRespond.respond
        
  
        // 2. 配置Toast核心区域（黑色区域）
        // 颜色
        MCToastConfig.shared.background.color = UIColor.black
        // 大小
        MCToastConfig.shared.background.size = CGSize(width: 120, height: 120)
        
        
        // 3. 配置状态Toast（成功，失败，警告等状态）的Icon
        MCToastConfig.shared.icon.size = CGSize(width: 50, height: 50)
        MCToastConfig.shared.icon.successImage = UIImage(named: "你成功状态的Icon")
        MCToastConfig.shared.icon.failureImage = UIImage(named: "你失败状态的Icon")
        MCToastConfig.shared.icon.warningImage = UIImage(named: "你警告状态的Icon")

        
        // 4. 配置文字
        MCToastConfig.shared.text.font = UIFont.systemFont(ofSize: 15)
        MCToastConfig.shared.text.textColor = UIColor.white
        MCToastConfig.shared.text.offset = (UIScreen.main.bounds.size.height / 2 - 120 - 150)
        
        
        // 5. 配置间距
        // 外边距（toast距离屏幕边的最小边距
        MCToastConfig.shared.spacing.margin = 55
        // 内边距（toast和其中的内容的最小边距）
        MCToastConfig.shared.spacing.padding = 15
        
        
        // 6. 设置自动隐藏的时长
        MCToastConfig.shared.duration = 1.5
    }
}

使用

支持cocoPods

pod 'MCToast'

使用

• 显示纯文本

extension MCToast {
    /// 展示文字toast
    /// - Parameters:
    ///   - text: 文字内容
    ///   - offset: 距离屏幕Y轴中心的距离（正下，负上）
    ///   - duration: 显示的时间（秒）
    ///   - respond: 交互类型
    ///   - callback: 隐藏的回调
    public static func mc_text(_ text: String,
                               offset: CGFloat? = nil,
                               duration: CGFloat = MCToastConfig.shared.duration,
                               respond: MCToast.MCToastRespond = MCToastConfig.shared.respond,
                               callback: MCToast.MCToastCallback? = nil) {
        
        DispatchQueue.main.async {
            MCToast.showText(text, offset: offset, duration: duration, respond: respond, callback: callback)
        }
    }
}

// 简单使用
MCToast.mc_text("修改成功")
// 长文本的换行使用
MCToast.mc_text("这是一个很长长长长长长长长长长长长长长长的纯文本的展示")
// 设置文本的偏移量。（以屏幕中心点为原点，正下负上）
MCToast.mc_text("居中显示", offset: 0)
// 全量设置
MCToast.mc_text("设置成功", offset: 100, duration: 2, respond: .default) {
 print("移除了")
}

• 带状态的Toast

 /// 成功的Toast
 MCToast.mc_success("可能出现的长文本提示长文本内容")
 /// 失败的Toast
 MCToast.mc_failure("失败")
 /// 警告的Toast
 MCToast.mc_warning("警告")
 /// 自定义的状态Toast
 MCToast.mc_codeSuccess()
 extension MCToast {
     /// 发送验证码成功
     public static func mc_codeSuccess() {
         let image = UIImage.init(named: "codesend")
         MCToast.showStatus(nil, text: "发送验证码成功", iconImage: image, duration: 2, respond: .respond)
     }
 }

• loading

  /// 系统的loading
  MCToast.mc_loading()
  /// 自定义的帧动画loading
  MCToast.mc_loading(imageNames: images)
  /// Json动画的loading （集成了Lottie库）
  let animation = Animation.named("JSON动画")
  MCToast.mc_loading(animation: animation) 

• 您也可以直接用self调用。
  作者通过给UIResponder添加扩展，达到了使用self调用的功能。

extension UIResponder { }

self.mc_text("这是一个纯文本的展示", duration: 2)
self.mc_statusBar("有内容更新啦，赶紧看看吧")

• 隐藏

// 调用的时候，通过设置展示时间，隐藏
self.mc_text("这是一个纯文本的展示", duration: 2)
// 通过其他方法隐藏
self.mc_remove() 
// 或者 MCToast.mc_remove()

• 其他更详细的使用请查看Demo

说明

1. 由于Toast是展示在Window上的，页面返回正在显示的Toast并不会消失。可以在页面的生命周期内调用MCToast.mc_remove()方法达到页面返回消失的目的。