UITableViewCell拖拽重排时背景视图切换异常求助

需求：列表项拖拽重排时，Cell背景显示systemThinMaterial半透明材质；未拖拽时Cell背景透明，显示TableView的背景视图。当前代码无法实现该效果。

现有代码 #

func tableView(_ tableView: UITableView, dragPreviewParametersForRowAt indexPath: IndexPath) -> UIDragPreviewParameters? {
    // Create a copy of the cell for drag preview
    guard let cell = tableView.cellForRow(at: indexPath) else { return nil }
    
    // Create a visual effect view with blur effect
    let blurEffectView = UIVisualEffectView(effect: UIBlurEffect(style: .systemThinMaterial))
    blurEffectView.frame = cell.bounds
    
    // Create a preview parameters object
    let previewParameters = UIDragPreviewParameters()
    let previewView = UIView(frame: cell.bounds)
    previewView.addSubview(blurEffectView)
    previewParameters.visiblePath = UIBezierPath(roundedRect: previewView.bounds, cornerRadius: 0)
    previewParameters.backgroundColor = .clear
    
    return previewParameters
}

override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
    cell.backgroundColor = .clear
    let item = fetchedResultsController.object(at: indexPath)
    cell.contentConfiguration = UIHostingConfiguration {
        ItemRow(item: item)
    }
    return cell
}

问题分析 #

原代码的核心问题是：dragPreviewParametersForRowAt方法中创建的模糊视图并未被实际应用到拖拽预览上。该方法仅用于修改默认预览的可见区域、背景色等参数，无法替换预览的内容视图，因此拖拽时还是显示原Cell的透明背景。

解决方案 #

通过自定义UIDragItem的预览视图，将模糊背景与Cell内容结合，具体步骤如下：

1. 实现tableView(_:itemsForBeginning:at:)方法，为拖拽项设置自定义预览提供者：

override func tableView(_ tableView: UITableView, itemsForBeginning session: UIDragSession, at indexPath: IndexPath) -> [UIDragItem] {
    let item = fetchedResultsController.object(at: indexPath)
    // 根据你的数据类型调整ItemProvider的创建方式
    let itemProvider = NSItemProvider(object: item as NSItemProviderWriting)
    let dragItem = UIDragItem(itemProvider: itemProvider)
    
    // 自定义拖拽预览视图
    dragItem.previewProvider = {
        guard let cell = tableView.cellForRow(at: indexPath) else { return nil }
        
        // 创建和Cell尺寸一致的容器视图
        let previewContainer = UIView(frame: cell.bounds)
        previewContainer.backgroundColor = .clear
        
        // 复制Cell的内容视图到容器中，保留原有内容
        if let contentSnapshot = cell.contentView.snapshotView(afterScreenUpdates: true) {
            previewContainer.addSubview(contentSnapshot)
        }
        
        // 添加systemThinMaterial风格的模糊背景
        let blurEffect = UIBlurEffect(style: .systemThinMaterial)
        let blurView = UIVisualEffectView(effect: blurEffect)
        blurView.frame = previewContainer.bounds
        // 将模糊视图放在内容下方
        previewContainer.insertSubview(blurView, at: 0)
        
        // 返回自定义预览
        return UIDragPreview(view: previewContainer)
    }
    
    return [dragItem]
}

2. 保留原有的cellForRowAt设置，确保未拖拽时Cell背景透明：

override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
    cell.backgroundColor = .clear
    let item = fetchedResultsController.object(at: indexPath)
    cell.contentConfiguration = UIHostingConfiguration {
        ItemRow(item: item)
    }
    return cell
}

3. 确保TableView有可见的背景视图（示例）：

override func viewDidLoad() {
    super.viewDidLoad()
    // 设置TableView背景（可替换为你需要的背景视图）
    tableView.backgroundView = UIImageView(image: UIImage(named: "your_background_image"))
    tableView.backgroundColor = .clear
}

4. 移除原有的dragPreviewParametersForRowAt方法（如果不需要调整预览的圆角等参数），或者保留并按需修改可见路径。

内容的提问来源于stack exchange，提问作者User95797654974