Swift中NSOutlineView使用.gap拖拽样式时出现位置异常问题求助

我之前也碰到过NSOutlineView拖拽反馈的类似坑，给你梳理下问题根源和可落地的解决办法：

问题根源 #

当你设置draggingDestinationFeedbackStyle = .gap时，NSOutlineView在处理拖拽到列表底部边界的场景时，会出现参数异常：proposedItem返回nil、index返回0——这和拖拽到列表顶部的参数完全一致，导致你的代码无法区分两种场景，最终错误地把节点插入到顶部。而默认样式下框架会正确传递底部对应的index（即列表总行数），所以不会出问题。

另外，你在validateDrop里每次重新设置draggingDestinationFeedbackStyle也没必要，建议初始化时一次性配置好，避免框架内部状态混乱。

解决方案 #

我们需要通过鼠标拖拽位置手动区分“顶部”和“底部”的拖拽场景，修正目标位置参数：

1. 先在OutlineView初始化阶段一次性设置拖拽反馈样式：

outlineView.registerForDraggedTypes([.string])
outlineView.draggingDestinationFeedbackStyle = .gap // 初始化时设置即可

2. 修改validateDrop方法，通过鼠标位置判断是否拖拽到底部，手动修正proposed的位置：

func outlineView(_ outlineView: NSOutlineView, validateDrop info: NSDraggingInfo, proposedItem item: Any?, proposedChildIndex index: Int) -> NSDragOperation {
    // 处理无效拖拽场景
    if index < 0 && item == nil {
        return []
    }
    
    // 判断是否拖拽到底部边界
    let mouseLocation = info.draggingLocation
    let pointInView = outlineView.convert(mouseLocation, from: nil)
    let bottomThreshold: CGFloat = 20 // 可根据你的行高（15）调整阈值大小
    let isDraggingToBottom = pointInView.y > outlineView.bounds.maxY - bottomThreshold
    
    if isDraggingToBottom {
        // 手动指定目标位置为最后一行之后
        outlineView.setDropItem(nil, dropChildIndex: outlineView.numberOfRows)
    }
    
    return .move
}

3. 同步修改acceptDrop方法，确保插入位置正确：

func outlineView(_ outlineView: NSOutlineView, acceptDrop info: NSDraggingInfo, item: Any?, childIndex index: Int) -> Bool {
    guard let pasteboardStr = info.draggingPasteboard.string(forType: .string),
          let sourceRow = Int(pasteboardStr),
          let sourceItem = outlineView.item(atRow: sourceRow) as? Catalog else {
        return false
    }
    
    // 再次校验是否拖拽到底部，修正目标index
    let mouseLocation = info.draggingLocation
    let pointInView = outlineView.convert(mouseLocation, from: nil)
    let bottomThreshold: CGFloat = 20
    let targetIndex = pointInView.y > outlineView.bounds.maxY - bottomThreshold ? outlineView.numberOfRows : index
    
    // 执行你的节点移动逻辑
    moveNode(sourceRow, outlineView.row(forItem: item), targetIndex)
    outlineView.reloadData()
    
    return true
}

补充说明 #

• 阈值bottomThreshold可以根据行高灵活调整，比如设为行高的1.5倍，确保拖拽到列表底部附近时能准确触发判断。
• 避免在validateDrop中反复修改draggingDestinationFeedbackStyle，防止框架内部状态冲突。

这样修改后，拖拽到底部时节点就会正确插入到列表末尾，不会再跑到顶部了。

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