如何通过Tab键切换到滚动视图外的Cocoa文本编辑字段

这个问题我之前做macOS开发时也碰到过！核心原因是AppKit默认的焦点循环逻辑会忽略不在可视区域内的控件，那些被滚出滚动视图范围的NSTextView自然就被排除在Tab切换的候选之外了。下面给你几个实用的解决办法：

你需要给滚动视图的文档视图（也就是承载子视图的那个容器视图）做个自定义子类，重写两个关键方法，强制把所有子视图里的NSTextView纳入焦点循环：

如果是Objective-C：

@interface CustomDocumentView : NSView
@end

@implementation CustomDocumentView

- (BOOL)acceptsFirstResponder {
    return YES; // 让文档视图本身能参与焦点循环
}

- (NSArray *)keyViewLoop {
    // 遍历所有子视图，收集所有NSTextView（可按你需要的Tab顺序调整）
    NSMutableArray *textViews = [NSMutableArray array];
    [self enumerateSubviewsUsingBlock:^(NSView *subview, BOOL *stop) {
        if ([subview isKindOfClass:[NSTextView class]] && [(NSTextView *)subview isEditable]) {
            [textViews addObject:subview];
        }
    }];
    return textViews;
}

@end

如果是Swift：

class CustomDocumentView: NSView {
    override var acceptsFirstResponder: Bool {
        return true
    }
    
    override var keyViewLoop: [NSView]? {
        var textViews = [NSView]()
        enumerateSubviews { subview, stop in
            if let textView = subview as? NSTextView, textView.isEditable {
                textViews.append(textView)
            }
        }
        return textViews
    }
}

这样AppKit就能识别到所有文本框，哪怕它们当前不在可视区域内，Tab切换时也会自动滚动到对应的位置并聚焦。

如果上面的方法不生效，你可以在顶层窗口或者初始聚焦的文本框里拦截Tab事件，手动找到下一个目标文本框并完成聚焦+滚动操作：

Swift示例（在顶层文本框子类中）：

override func keyDown(with event: NSEvent) {
    // 判断是否是Tab键（非Shift+Tab）
    if event.keyCode == 48, !event.modifierFlags.contains(.shift) {
        guard let documentView = self.window?.contentView?.subviews.first(where: { $0 is CustomDocumentView }) as? CustomDocumentView else {
            super.keyDown(with: event)
            return
        }
        // 收集所有可编辑的NSTextView
        let allTextViews = documentView.subviews.compactMap { $0 as? NSTextView }.filter { $0.isEditable }
        // 找到当前聚焦的文本框的索引
        guard let currentIndex = allTextViews.firstIndex(of: self) else {
            super.keyDown(with: event)
            return
        }
        // 计算下一个索引（循环到开头如果是最后一个）
        let nextIndex = (currentIndex + 1) % allTextViews.count
        let nextTextView = allTextViews[nextIndex]
        
        // 聚焦并滚动到目标位置
        nextTextView.becomeFirstResponder()
        if let scrollView = documentView.enclosingScrollView {
            scrollView.scroll(to: nextTextView.frame, relativeTo: documentView)
            scrollView.reflectScrolledClipView(scrollView.contentView)
        }
        return
    }
    // 其他按键交给父类处理
    super.keyDown(with: event)
}

• 确保所有NSTextView的isEditable和isSelectable都设为true，否则它们不会被纳入焦点候选。
• 如果滚动视图开启了autohidesScrollers，可以暂时关闭测试，某些极端场景下这个属性会干扰焦点循环判断。

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