[iOS][Swift] tableView左滑事件的简介

本文翻译自http://www.brianjcoleman.com/tutorial-swipe-actions-for-uitableviewcell-in-swift/

先看一下成品的效果,点击后会有一个事件发生的哦

有时候,我们希望用户在滑动tableViewCell的时候能够出现更多的选项,很多人都知道在iOS原生的邮件app中,在邮件列表中左滑会出现三个按钮:更多,旗标,删除(原文为Archive,但是ios9中为删除 -译者注),让我们一起来学习如何自定义这三个按钮,同时点击后有各自对应的事件发生.

UITABLEVIEWROWACTION

一个UITableViewRowAction对象定义了一个单一的事件,当用户在tableViewCell上横向滑动的时候就会出现.在一个处于编辑状态的tableView中,默认情况下左滑会出现一个删除按钮.这个类(指UITableViewRowAction,下同 -译者注)可以让你在左滑的时候出现一个,两个,甚至更多的按钮.这个类的每一个实例都代表着一个要执行的操作,并且包含了显示的文本,格式信息和点击后的行为.

如果要给tableView的某一行添加自定义的UITableViewRowAction,你需要实现
tableView(tableView: UITableView, editActionsForRowAtIndexPath indexPath: NSIndexPath)这个方法,该方法存在于tableView的delegate协议中.在该方法中创建并且返回action,tableView将会自动处理接下来的事情:显示按钮、点击的时候执行闭包中的代码等.

(下面是该方法的一个例子 -译者注)

func tableView(tableView: UITableView, editActionsForRowAtIndexPath indexPath: NSIndexPath) -> [AnyObject]? {
    let more = UITableViewRowAction(style: .Normal, title: "More") { action, index in
        println("more button tapped")
    }
    more.backgroundColor = UIColor.lightGrayColor()
    
    let favorite = UITableViewRowAction(style: .Normal, title: "Favorite") { action, index in
        println("favorite button tapped")
    }
    favorite.backgroundColor = UIColor.orangeColor()
    
    let share = UITableViewRowAction(style: .Normal, title: "Share") { action, index in
        println("share button tapped")
    }
    share.backgroundColor = UIColor.blueColor()
    
    return [share, favorite, more]
}

使用这个方法可以赋予你的cell三个自定义的action,当用户左滑的时候,这三个按钮就会显示出来,点击其中的一个按钮,闭包中的代码将会被执行.

这个方法返回一个UITableViewRowAction类型的数组,数组中的每一个元素都会让tableViewCell创建一个可用于点击的按钮.

下面是预览:

事实上如果你仅仅用了上面的代码,你会发现没有效果,这就是看文章不看完的代价,哈哈,为了让上面的方法生效,我们还需要实现下面的方法:

func tableView(tableView: UITableView, canEditRowAtIndexPath indexPath: NSIndexPath) -> Bool {
    // 要显示自定义的action,cell必须处于编辑状态
    return true
}

func tableView(tableView: UITableView, commitEditingStyle editingStyle: UITableViewCellEditingStyle, forRowAtIndexPath indexPath: NSIndexPath) {
    // 同时你也需要实现本方法,否则自定义action是不会显示的,啦啦啦
}

第一个方法canEditRowAtIndexPath允许你的cell进入编辑状态,第二个方法commitEditingStyle也需要实现,否则你无法通过左滑来显示自定义action.

在iOS8中,Apple开放了editActionsForRowAtIndexPath这个方法,该方法在iOS7中是一个私有方法,Apple在iOS自带的邮件app中使用了这个方法,他们好像对一些新的特性也做了同样禽兽不如的事,比如从cell的左侧一直滑动到右侧就会触发一个action,右滑出现自定义action按钮,这两个方法在iOS8中是私有的,但是在iOS9中就被公开了.

点击这里前往下载项目源码(Xcode6.3,Swift1.2)