SwipeCellKit高级功能指南：自定义过渡与扩展行为-优快云博客

SwipeCellKit高级功能指南：自定义过渡与扩展行为

SwipeCellKit Swipeable UITableViewCell/UICollectionViewCell based on the stock Mail.app, implemented in Swift. 项目地址: https://gitcode.com/gh_mirrors/sw/SwipeCellKit

前言

SwipeCellKit是一个功能强大的iOS滑动操作组件库，它提供了丰富的自定义选项来满足各种交互需求。本文将深入探讨SwipeCellKit的两个核心高级功能：自定义过渡动画和扩展行为配置，帮助开发者实现更精细的滑动交互效果。

自定义过渡动画

基本概念

在SwipeCellKit中，过渡动画指的是当用户滑动单元格时，操作按钮从隐藏到显示过程中的动画效果。默认情况下，按钮会简单地淡入淡出，但我们可以通过transitionDelegate属性实现更丰富的动画效果。

内置过渡效果

框架提供了ScaleTransition类型，它实现了"弹出"效果的过渡动画：

let action = SwipeAction(style: .default, title: "更多") { action, indexPath in 
    // 处理点击事件
}
action.transitionDelegate = ScaleTransition.default

ScaleTransition的工作原理是：

监控操作按钮的可见状态
当按钮超过阈值(threshold)时开始动画
在初始比例(initialScale)和原始大小(identity)之间进行平滑过渡

自定义参数

除了使用默认配置，你还可以创建自定义参数的ScaleTransition实例：

let customTransition = ScaleTransition(initialScale: 0.5, threshold: 0.3)
action.transitionDelegate = customTransition

完全自定义过渡

要实现完全自定义的过渡效果，需要遵循SwipeActionTransitioning协议。该协议提供了SwipeActionTransitioningContext上下文对象，包含当前滑动手势的所有状态信息，开发者可以利用这些信息创建独特的过渡动画。

自定义扩展行为

扩展行为概述

扩展行为指的是当用户滑动超过特定阈值时，操作按钮的展开效果。SwipeCellKit通过SwipeExpansionStyle类型提供了高度可配置的扩展行为设置。

核心配置参数

目标(target)：定义触发扩展的相对阈值
- .percentage(CGFloat)：基于父视图宽度的百分比(0.0到1.0)
- .edgeInset(CGFloat)：从父视图对边的偏移量(以点为单位)
附加触发器(additionalTriggers)：补充默认目标触发的额外条件
- .touchThreshold(CGFloat)：触摸超过指定百分比时触发
- .overscroll(CGFloat)：滑动超过完全显示操作视图的距离时触发
弹性滑动(elasticOverscroll)：控制按钮是否填满额外空间
- 启用时，按钮只填充25%的额外空间
- 禁用时，按钮完全填满可用空间
完成动画(completionAnimation)：定义触摸抬起时的动画效果
- .fill(FillOptions)：完全展开填充单元格原位置
- .bounce：从触发点弹回并隐藏操作视图

填充选项详解

FillOptions允许精细控制填充动画：

实现样式(ExpansionFulfillmentStyle)：
- 自动(automatic)：自动处理删除等操作
- 手动(manual)：允许开发者异步控制操作完成
处理程序调用时机(HandlerInvocationTiming)：
- .with：与填充动画同时调用
- .after：填充动画完成后调用

内置扩展样式

SwipeCellKit提供了四种预定义的扩展样式：

选择样式(.selection)：
- 目标：50%宽度
- 弹性滑动：启用
- 完成动画：弹回效果
破坏性样式(.destructive)：
- 目标：30点偏移
- 附加触发器：80%触摸阈值
- 完成动画：填充并立即删除
填充后破坏性样式(.destructiveAfterFill)：
- 类似破坏性样式，但在填充动画完成后删除
填充样式(.fill)：
- 目标：30点偏移
- 附加触发器：30点滑动阈值
- 完成动画：手动控制填充

按钮行为自定义

扩展代理

通过设置SwipeOptions的expansionDelegate，可以自定义按钮的扩展行为。框架提供了ScaleAndAlphaExpansion类型，它在扩展时自动缩放和淡入淡出其他操作按钮。

var options = SwipeOptions()
options.expansionDelegate = ScaleAndAlphaExpansion.default

完全自定义扩展

遵循SwipeExpanding协议可以实现完全自定义的扩展行为，包括：

自定义动画时间参数
控制扩展/收缩过程中的按钮表现

高单元格垂直居中解决方案

对于高度较大的单元格，可以使滑动操作按钮在可见区域内垂直居中显示。

实现方法

在单元格代理中实现visibleRect(for:)方法，返回可见区域的矩形：

// iOS 11+ 简单实现
func visibleRect(for tableView: UITableView) -> CGRect? {
    return tableView.safeAreaLayoutGuide.layoutFrame
}

// 早期iOS版本实现
func visibleRect(for tableView: UITableView) -> CGRect? {
    let topInset = navigationController?.navigationBar.frame.height ?? 0
    let bottomInset = navigationController?.toolbar?.frame.height ?? 0
    let bounds = tableView.bounds
    
    return CGRect(x: bounds.origin.x, 
                 y: bounds.origin.y + topInset, 
                 width: bounds.width, 
                 height: bounds.height - bottomInset)
}