[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)
