[Swift通天遁地]二、表格表单-(7)电子邮件Mail：实现单元格左右滑动调出功能按钮

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★
➤微信公众号：山青咏芝（shanqingyongzhi）
➤博客园地址：山青咏芝（https://www.cnblogs.com/strengthen/）
➤GitHub地址：https://github.com/strengthen/LeetCode
➤原文地址：https://www.cnblogs.com/strengthen/p/10189864.html 
➤如果链接不是山青咏芝的博客园地址，则可能是爬取作者的文章。
➤原文已修改更新！强烈建议点击原文地址阅读！支持作者！支持原创！
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★

目录：[Swift]通天遁地Swift

本文将演示对单元格进行扩展，当手指在单元格左右滑动时，弹出不同的功能菜单。

Github项目：【MGSwipeTableCell】

下载该项目的源代码。文件夹【demo】->文件夹【MailAppDemoSwift】->文件夹【MailAppDemoSwift】

->双击文件【MailAppDemoSwift。xcodeproj】打开示例工程。

选择该项目中的几个文件，拖动到自己的开发项目中。按住【Shift】，选择

【MGSwipeButton.h】

【MGSwipeButton.m】

【MGSwipeTableCell.h】

【MGSwipeTableCell.m】

按下【Command】,以选择其他不相邻的文件。

【MailViewController.swift】

【MailTableCell.swift】

【ObjCBridgingHeader.h】

将上面选择的7个文件拖动到自己的项目中。

->保持默认的设置选项，点击【Finish】

接着对项目进行一些设置，以引入桥接文件。

点击项目名称【DemoApp】->【Buildings】->桥接文件配置区域【Object-C Bridging Header】

->在配置选项中双击，打开配置窗口。

->在配置窗口中，输入刚刚导入的桥接文件的名称：【DemoApp/ObjCBridgingHeader.h】

在项目导航区，打开视图控制器的代码文件【ViewController.swift】

现在开始编写代码，创建一个可通过左右滑动，来调出功能按钮的表格。

import UIKit

//添加一个邮件数据类，这个类将用来表示表格中的数据
class MailData
{
    //给类添加四个属性：
    //1.来源
    var from: String!
    //2.主题
    var subject: String!
    //3.内容
    var message: String!
    //4.日期
    var date: String!
    //添加两个属性
    //1.邮件是否已被阅读
    var read = false
    //2.邮件是否拥有标记
    var flag = false
}

//创建一个别名，表示功能按钮被点击时所执行的方法的类型。
typealias MailActionCallback = (_ cancelled: Bool, _ deleted: Bool, _ actionIndex: Int) -> Void

//使当前的视图控制器类，遵循：
//1.表格的数据源协议UITableViewDataSource
//2.表格视图代理协议UITableViewDelegate
//3.滑动表格单元格代理协议
//4.动作表单协议
class ViewController: UIViewController, UITableViewDataSource, UITableViewDelegate, MGSwipeTableCellDelegate, UIActionSheetDelegate
{
    //添加一个表格视图类型的变量，作为当前类的一个属性
    var tableView: UITableView!
    //创建一个邮件数据类型的数组，作为表格的数据源
    var demoData = [MailData]()
    //使用刚刚创建的别名，创建一个动作类型
    var actionCallback: MailActionCallback?
    
    //添加一个方法，用来设置表格的数据源
    func prepareDemoData()
    {
        //创建第一个字符串数组常量，作为邮件的来源
        var from = [
            "Vincent",
            "Mr Glass",
            "Marsellus",
            "Ringo",
            "Sullivan"
        ]
        
        //创建第二个字符串数组常量，作为邮件的主题
        var subjects = [
            "You think water moves fast?",
            "They called me Mr Glass",
            "The path of the righteous man",
            "Do you see any Teletubbies in here?",
            "Now that we know who you are"
        ]
        
        //创建第三个字符串数组常量，作为邮件的信息
        var messages = [
            "You should see ice. It moves like it has a mind. ",
            "And I will strike down upon thee with great vengeance and furious anger.",
            "Look, just because I don't be givin' no man a foot massage don't make it right.",
            "No? Well, that's what you see at a toy store.",
            "In a comic, you know how you can tell who the arch-villain's going to be?"
        ]
        
        //通过一个循环，遍历信息数组
        for i in 0 ..< messages.count
        {
            //创建一个邮件数据对象
            let mail = MailData()
            //从数组中加载相应的内容
            mail.from = from[i]
            //并依次设置邮件数据对象的各个属性
            mail.subject = subjects[i]
            mail.message = messages[i]
            //设置邮件数据对象的时间属性
            mail.date = String(format: "11:%d", arguments: [43 - i])
            //将邮件数据对象，添加到表格的数据源数组当中
            demoData.append(mail)
        }
    }
    
    //添加一个方法
    //用来从数据源数组中，根据单元格的位置获得相应的数据
    func mailForIndexPath(_ path: IndexPath) -> MailData
    {
        //根据单元格的行号，返回数据源数组中的数据
        return demoData[(path as NSIndexPath).row]
    }
    
    //添加一个方法
    //用来响应单元格中的删除按钮被点击时的事件
    func deleteMail(_ path:IndexPath)
    {
        //从数据源数组中删除指定位置的数据
        demoData.remove(at: (path as NSIndexPath).row)
        //从表格中删除指定的单元格
        tableView.deleteRows(at: [path], with: .left)
    }
    
    //添加一个方法
    //当邮件的状态改变时调用此方法
    //例如邮件从未读转换为已读
    func updateCellIndicator(_ mail: MailData, cell: MailTableCell)
    {
        //创建两个颜色变量，作为标识邮件状态的图标的颜色
        var color: UIColor
        var innerColor : UIColor?
        
        //根据邮件不同的状态，设置邮件不同的颜色
        if !mail.read && mail.flag
        {
            //当邮件未读并有标识时
            //设置标识图标的标识颜色
            color = UIColor.init(red: 1.0, green: 149/255.0, blue: 0.05, alpha: 1.0)
            //设置标识图标内部的颜色
            innerColor = UIColor.init(red: 0.0, green: 122/255.0, blue: 1.0, alpha: 1.0)
        }
        else if mail.flag
        {
            //当邮件具有标识时，
            //设置标识图标的标识颜色
            color = UIColor.init(red: 1.0, green: 149/255.0, blue: 0.05, alpha: 1.0)
        }
        else if mail.read
        {
            //当邮件处于已读状态时，
            //设置标识图标的颜色为无色
            //即在视觉上隐藏该图标
            color = UIColor.clear
        }
        else
        {
            //设置邮件在其他状态下的默认颜色
            color = UIColor.init(red: 0.0, green: 122/255.0, blue: 1.0, alpha: 1.0)
        }
        
        //设置标识图标的颜色
        cell.indicatorView.indicatorColor = color
        //设置标识图标内部的颜色
        cell.indicatorView.innerColor = innerColor
    }
    
    //添加一个方法，用来弹出一个动作表单
    func showMailActions(_ mail: MailData, callback: @escaping MailActionCallback)
    {
        //设置动作属性的值
        actionCallback = callback
        
        //初始化一个动作表单，依次设置相关参数
        let sheet = UIActionSheet.init(title: "Actions", //标题
                                       delegate: self,//代理
                                       cancelButtonTitle: "Cancel",//取消按钮的标题
                                       destructiveButtonTitle: "Trash")//销毁按钮的标题
        
        //往动作表单中依次添加三个按钮，
        //并设置三个按钮的标题文字
        sheet.addButton(withTitle: "Mark as unread")
        sheet.addButton(withTitle: "Mark as read")
        sheet.addButton(withTitle: "Flag")
        
        //在根视图中显示动作表单
        sheet.show(in: self.view)
    }
    
    //添加一个代理方法，用来监听动作表单中的选项被点击时的事件
    func actionSheet(_ actionSheet: UIActionSheet, clickedButtonAt index: Int)
    {
        //获得当前类的属性的值
        if let action = actionCallback
        {
            //根据点击的不同选项，执行不同的操作
            action(index == actionSheet.cancelButtonIndex,
                   index == actionSheet.destructiveButtonIndex,
                   index)
            actionCallback = nil
        }
    }
    
    //添加一个方法，用来根据不同的标识状态，返回不同的文字内容
    func readButtonText(_ read:Bool) -> String
    {
        return read ? "Mark as
unread" : "Mark as
read"
    }
    
    
    override func viewDidLoad()
    {
        super.viewDidLoad()
        
        //初始化一个矩形区域，作为表格的显示区域
        let frame = CGRect(x: 0, y: 20,  320, height: 548)
        //创建一个指定显示区域的表格视图
        tableView = UITableView(frame: frame, style: UITableViewStyle.plain)
        
        //设置表格对象的数据源为当前的视图控制器对象
        tableView.delegate = self
        //设置表格对象的代理为当前的视图控制器对象
        tableView.dataSource = self
        //将表格视图添加到根视图中
        view.addSubview(tableView)
        
        //调用方法，用来初始化表格的数据源
        prepareDemoData()
    }
    
    //添加一个代理方法，用来设置表格的行数
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int
    {
        //在此设置表格的行数为数组的长度
        return demoData.count
    }
    
    //添加一个代理方法，用来初始化或复用表格中的单元格
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell
    {
        //创建一个字符串常量，作为单元格的复用标识
        let identifier = "MailCell"
        //根据复用标识，从表格中获得可以复用的单元格
        var cell: MailTableCell! = tableView.dequeueReusableCell(withIdentifier: identifier) as? MailTableCell

        //如果没有可以复用的单元格
        if cell == nil
        {
            //则初始化一个默认样式的单元格，并设置单元格的复用标识
            cell = MailTableCell(style: UITableViewCellStyle.default, reuseIdentifier: identifier)
        }
        //设置单元格的代理对象为当前的视图控制器对象
        cell.delegate = self
        
        //根据当前单元格的行号，获得数组中对应的邮件数据
        let data: MailData = demoData[(indexPath as NSIndexPath).row]
        //设置单元格的邮件来源标签的文字内容
        cell!.mailFrom.text = data.from
        //依次设置其他标签的相关内容
        cell!.mailSubject.text = data.subject
        cell!.mailMessage.text = data.message
        cell!.mailTime.text = data.date
        
        //调用方法，根据邮件的状态，刷新单元格的视觉效果
        updateCellIndicator(data, cell: cell)
        
        //最后返回设置好的单元格对象
        return cell
    }
    
    //添加一个代理方法，用来设置单元格的高度为110
    func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat
    {
        return 110
    }
    
    //添加一个代理方法，设置单元格允许滑动的手势
    func swipeTableCell(_ cell: MGSwipeTableCell, canSwipe direction: MGSwipeDirection) -> Bool
    {
        return true
    }
    
    //添加一个代理方法，设置当单元格上有滑动手势时，所显示的功能按钮，以及功能按钮显示的视觉效果
    func swipeTableCell(_ cell: MGSwipeTableCell, swipeButtonsFor direction: MGSwipeDirection, swipeSettings: MGSwipeSettings, expansionSettings: MGSwipeExpansionSettings) -> [UIView]?
    {
        //设置功能按钮的显示方式为三维旋转效果。
        //共有：边缘、静态、拖动、中心裁切、三维旋转等五种效果
        swipeSettings.transition = MGSwipeTransition.rotate3D
        //设置功能按钮的索引为0
        expansionSettings.buttonIndex = 0
        
        //获得在当前单元格中，需要显示的邮件内容
        let mail = mailForIndexPath(tableView.indexPath(for: cell)!)
        
        //处理当手势为从左到右滑动时的情况
        if direction == MGSwipeDirection.leftToRight
        {
            //设置在该手势下，按钮将以弹性的方式返回原来的位置
            expansionSettings.fillOnTrigger = false
            //设置触发显示功能按钮的阈值大小，默认值为1.5
            expansionSettings.threshold = 2
            //初始化一个颜色常量，作为功能按钮的背景颜色
            let color = UIColor.init(red:0.0, green:122/255.0, blue:1.0, alpha:1.0)
            
            //返回一个功能按钮，并设置按钮的标题、背景颜色和交互动作
            return [
                MGSwipeButton(title: readButtonText(mail.read),//标题
                              backgroundColor: color,//背景颜色
                              callback: { (cell) -> Bool in//交互动作
                              //当该按钮被点击时，将切换当前邮件的阅读状态
                              mail.read = !mail.read
                              //同时刷新当前邮件所在单元格的外观状态
                              self.updateCellIndicator(mail, cell: cell as! MailTableCell)
                              //接着刷新单元格的内容视图
                              cell.refreshContentView()
                              //根据邮件的阅读状态的变化，刷新被添加按钮的标题文字
                              (cell.leftButtons[0] as! UIButton).setTitle(self.readButtonText(mail.read), for: UIControlState())
                    
                    //最后返回真，使功能按钮自动隐藏，结束按钮的点击事件
                    return true
                })
            ]
        }
        else
        {
            //处理当手势为从右到左滑动时的情况

            //设置在该手势下，按钮将在触发时填充单元格
            expansionSettings.fillOnTrigger = true
            //设置触发显示功能按钮的阈值大小1.1，默认值为1.5
            expansionSettings.threshold = 1.1
            
            //设置按钮的内边距为15
            let padding = 15
            //初始化三个颜色常量，作为三个按钮的背景颜色
            let color1 = UIColor.init(red:1.0, green:59/255.0, blue:50/255.0, alpha:1.0)
            let color2 = UIColor.init(red:1.0, green:149/255.0, blue:0.05, alpha:1.0)
            let color3 = UIColor.init(red:200/255.0, green:200/255.0, blue:205/255.0, alpha:1.0)
            
            //添加第一个功能按钮，依次设置相关参数
            let trash = MGSwipeButton(title: "Trash",//标题
                                      backgroundColor: color1, //背景颜色
                                      padding: padding, //内间距
                                      callback: { (cell) -> Bool in//交互动作
                                      //当该按钮被点击时，
                                      //将从表格中移除按钮所在的单元格，
                                      //并在数组中移除该单元格的内容。
                                      self.deleteMail(self.tableView.indexPath(for: cell)!)
                return false
            })
            
            //添加第二个功能按钮，依次设置相关参数
            let flag = MGSwipeButton(title: "Flag",//标题
                                     backgroundColor: color2,//背景颜色
                                     padding: padding, //内间距
                                     callback: { (cell) -> Bool in//交互动作
                                     //获得在当前单元格中，需要显示的邮件内容
                                     let mail = self.mailForIndexPath(self.tableView.indexPath(for: cell)!)
                                     //更改邮件的标识状态
                                     mail.flag = !mail.flag
                                     //刷新当前邮件所在单元格的外观状态
                                     self.updateCellIndicator(mail, cell: cell as! MailTableCell)
                                     //刷新单元格的内容视图
                                     cell.refreshContentView()
                
                return true
            })
            
            //添加第三个功能按钮，依次设置相关参数
            let more = MGSwipeButton(title: "More", //标题
                                     backgroundColor: color3,//背景颜色
                                     padding: padding, //内间距
                                     callback: { (cell) -> Bool in//交互动作
                                     //获得当前单元格在表格中的位置
                                     let path = self.tableView.indexPath(for: cell)!
                                     //获得在当前单元格中，需要显示的邮件内容
                                     let mail = self.mailForIndexPath(path)
                
                //创建一个动作表单，拥有：取消、删除和索引三个选项
                self.showMailActions(mail, callback: { (cancelled, deleted, index) in
                    //取消选项被点击时的情况
                    if cancelled
                    {
                        return
                    }
                    //删除选项被点击时的情况
                    else if deleted
                    {
                        //此时删除当前的单元格，以及数组中的数据
                        self.deleteMail(path)
                    }
                    //索引选项被点击时的情况，当索引值为1时
                    else if index == 1
                    {
                        //更改邮件的阅读状态
                        mail.read = !mail.read
                        //根据更改后的阅读状态，刷新当前单元格的标识图标
                        self.updateCellIndicator(mail, cell: cell as! MailTableCell)
                        //同时刷新单元格的内容视图
                        cell.refreshContentView()
                        //根据邮件的阅读状态的变化，刷新被添加按钮的标题文字
                        (cell.leftButtons[0] as! UIButton).setTitle(self.readButtonText(mail.read), for: UIControlState())
                        //然后以动画的方式，隐藏功能按钮
                        cell.hideSwipe(animated: true)
                    }
                })
                //最后返回假，以保持功能按钮的显示状态
                return false
            })
            //在方法的末尾，返回三个功能按钮
            return [trash, flag, more]
        }
    }
    
    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }
}