Mac NSCollectionView 刪除 Cell 後，新的 Cell 按鈕短暫無法點擊

Jayden Kan — Sun, 15 Nov 2026 08:05:05 +0000

NSCollectionView 有 4 種排版：

排版 1：1 個 Cell（1）
排版 2：2 個 Cell（2）
排版 3：3 個 Cell（1 + 2）
排版 4：5 個 Cell（2 + 3）

問題描述

畫面目前有 5 個 Cell，使用排版 4（2 + 3）
使用者點擊第一排右側的 Close Button
Cell 被刪除，排版依剩餘 Cell 數量重新切換
使用者立即點擊原本的位置
該位置明明有 Close Button，卻沒有觸發刪除
停頓一小段時間後，又可以正常點擊

初步排查

使用 deleteItems(at:) 刪除 Cell，沒有呼叫 reloadData
只有排版改變時，才會發生點擊後沒有刪除的情況
把 deleteItems(at:) 改成每次都 reloadData，反而每次刪除後都會發生
prepareForReuse 沒有遺漏重置資料
刪除 Cell 時，main thread 上沒有耗時的工作

增加 Log 深入了解實際情況

多次嘗試沒有結果後，改從滑鼠事件本身調查。我請 AI 加入更完整的 Debug Log，觀察：

mouseDown 事件實際由哪個 Button 接收
mouseUp 事件的流向
NSEvent.clickCount 的變化
滑鼠目前位置透過 Hit Test 找到的 View

把過濾後的 Log 貼給 AI，能快速分析出情況，節省時間。

關鍵發現

快速連續點擊時，Log 出現了一個很特別的現象：clickCount 持續增加，但接收 mouseDown 的 Button 始終是同一個實例。

Click 1
clickCount = 1
mouseDown self = 0xbb545ed00   (Button A)
hitTest = Button A

Click 2
clickCount = 2
mouseDown self = 0xbb545ed00   (Button A)
hitTest = Button B

Click 3
clickCount = 3
mouseDown self = 0xbb545ed00   (Button A)
hitTest = Button B

這代表：

第一下點擊時，接收事件的是 Button A。
Cell 刪除並重新排版後，滑鼠下方已經變成 Button B（Hit Test 的結果）。
但後續點擊的 mouseDown，仍然由 Button A 接收。

畫面上滑鼠下方的 Button，和實際收到滑鼠事件的 Button，並不是同一個。

TODO（發文前請確認）：目前只觀察到現象，尚未確認 AppKit 為何在連續點擊時沿用舊的接收者，也沒驗證「停頓後恢復」是否與系統雙擊間隔有關。若有實測或文件佐證，請補在這裡；沒有的話，這段維持「觀察到的現象」即可。

解決方式：將事件交給正確的 Button

在 Button 的 mouseDown 中判斷事件是否真的落在自己身上：

覆寫 mouseDown
將滑鼠座標轉換到目前 Button 的座標系
檢查滑鼠位置是否位於自己的 bounds
如果在 bounds 內，照常處理
如果不在，重新做 Hit Test，找到游標下方真正的 Button，並把事件交給它處理

範例

final class CloseButton: NSButton {
    override func mouseDown(with event: NSEvent) {
        // 事件座標（window 座標）轉換成自己的座標系
        let localPoint = convert(event.locationInWindow, from: nil)

        if bounds.contains(localPoint) {
            super.mouseDown(with: event)
            return
        }

        // 事件被送到不在游標下方的舊 Button：重新 Hit Test。
        // hitTest(_:) 的參數必須是「接收者的 superview」座標系，
        // 所以從 contentView 的 superview 開始找。
        guard let root = window?.contentView?.superview else {
            super.mouseDown(with: event)
            return
        }
        let point = root.convert(event.locationInWindow, from: nil)

        if let target = root.hitTest(point) as? NSButton, target !== self {
            // NSButton 的 mouseDown 會自行追蹤到 mouseUp，
            // 所以只轉發 mouseDown 即可。
            target.mouseDown(with: event)
        } else {
            super.mouseDown(with: event)
        }
    }
}

注意事項：

目標可能是 Button 內部的子 View，必要時沿著 superview 往上找到 Button。
這個作法依賴 NSButton 自己會追蹤到 mouseUp。如果是自訂 View 並在 mouseUp 處理點擊，mouseUp 仍會回到原本的 View，需要另外處理。

Mac 所有 NSCollectionView 都需要覆寫 mouseDown 嗎？

不需要。這個問題只會在「快速連續點擊」加上「點擊後版面隨即重排，原位置換成另一個 Button」時出現。一般的刪除和點擊流程不受影響。

也不建議用 reloadData 來解決：排查時改用 reloadData 後，問題反而每次刪除都會發生。如果專案中有類似「點擊後版面立即變動，使用者又快速再點」的互動，再考慮加上這個覆寫。