SwiftUI中如何让TextField正确响应上下箭头按键事件？

问题原因分析 #

• 直接在TextField上使用.onKeyPress(.downArrow)无效，是因为TextField作为第一响应者会优先处理箭头键（用于光标移动），事件不会传递到SwiftUI的绑定回调。
• 自定义NSTextField子类的keyDown未触发，通常是因为没有正确设置acceptsFirstResponder = true，或者视图未成为第一响应者，也可能是NSViewRepresentable的配置遗漏了关键步骤。

解决方案1：利用SwiftUI原生FocusState + 父视图按键捕获 #

通过@FocusState管理每行TextField的焦点状态，在父容器上绑定按键事件，直接切换焦点索引。这种方法无需自定义NSView，纯SwiftUI实现：

import SwiftUI

struct MarkdownEditorView: View {
    @State private var lines: [String] = ["第一行", "第二行", "第三行"]
    @FocusState private var focusedLineIndex: Int?
    
    var body: some View {
        VStack(alignment: .leading, spacing: 4) {
            ForEach(Array(lines.enumerated()), id: \.offset) { index, line in
                TextField("输入行内容", text: $lines[index])
                    .focused($focusedLineIndex, equals: index)
                    .textFieldStyle(.plain)
            }
        }
        .padding()
        .onKeyPress(.downArrow) { _ in
            moveFocus(by: 1)
            return .handled
        }
        .onKeyPress(.upArrow) { _ in
            moveFocus(by: -1)
            return .handled
        }
    }
    
    private func moveFocus(by offset: Int) {
        let currentIndex = focusedLineIndex ?? 0
        let newIndex = currentIndex + offset
        focusedLineIndex = newIndex.clamped(to: 0..<lines.count)
    }
}

// 扩展帮助限制索引范围
extension Comparable {
    func clamped(to limits: ClosedRange<Self>) -> Self {
        return min(max(self, limits.lowerBound), limits.upperBound)
    }
}

注意事项 #

• 返回.handled会阻止TextField继续处理箭头键（比如光标不会左右移动），如果需要保留光标移动功能，可根据情况调整返回值。
• 初始状态下可以设置focusedLineIndex = 0让第一行默认获得焦点。

解决方案2：正确实现自定义NSTextField子类（macOS专属） #

如果需要更底层的按键控制，可通过NSViewRepresentable封装自定义NSTextField，确保keyDown方法被正确调用：

1. 自定义NSTextField子类 #

import AppKit

class LineTextField: NSTextField {
    var keyHandler: ((NSEvent) -> Bool)?
    
    override var acceptsFirstResponder: Bool {
        return true // 必须设置为true才能接收按键事件
    }
    
    override func keyDown(with event: NSEvent) {
        // 先调用自定义处理器，返回true则拦截事件，否则交给父类处理
        if let handler = keyHandler, handler(event) {
            return
        }
        super.keyDown(with: event)
    }
}

2. 封装为SwiftUI组件 #

struct LineEditor: NSViewRepresentable {
    @Binding var text: String
    var keyHandler: ((NSEvent) -> Bool)?
    
    func makeNSView(context: Context) -> LineTextField {
        let textField = LineTextField()
        textField.stringValue = text
        textField.delegate = context.coordinator
        textField.keyHandler = keyHandler
        textField.font = .systemFont(ofSize: 14)
        return textField
    }
    
    func updateNSView(_ nsView: LineTextField, context: Context) {
        if nsView.stringValue != text {
            nsView.stringValue = text
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(parent: self)
    }
    
    class Coordinator: NSObject, NSTextFieldDelegate {
        let parent: LineEditor
        
        init(parent: LineEditor) {
            self.parent = parent
        }
        
        func controlTextDidChange(_ obj: Notification) {
            guard let textField = obj.object as? NSTextField else { return }
            parent.text = textField.stringValue
        }
    }
}

3. 使用组件并处理按键切换 #

struct MarkdownEditorView: View {
    @State private var lines: [String] = ["自定义行1", "自定义行2", "自定义行3"]
    @FocusState private var focusedLineIndex: Int?
    
    var body: some View {
        VStack(alignment: .leading, spacing: 4) {
            ForEach(Array(lines.enumerated()), id: \.offset) { index, line in
                LineEditor(text: $lines[index]) { event in
                    // macOS键码：上箭头126，下箭头125
                    if event.keyCode == 125 {
                        focusedLineIndex = min(index + 1, lines.count - 1)
                        return true
                    } else if event.keyCode == 126 {
                        focusedLineIndex = max(index - 1, 0)
                        return true
                    }
                    return false
                }
                .focused($focusedLineIndex, equals: index)
            }
        }
        .padding()
    }
}

关键注意点 #

• 自定义NSTextField必须设置acceptsFirstResponder = true，否则无法接收按键事件。
• 在keyDown中如果拦截了事件（返回true），要确保焦点切换逻辑正确，避免用户无法正常编辑文本。
• 两种方案都依赖@FocusState来管理焦点，这是SwiftUI中控制视图焦点的原生方式，比手动操作第一响应者更可靠。

内容的提问来源于stack exchange，提问作者gavrilikhin.d