SwiftUI TextEditor如何忽略Shift+Return仅响应Return按键

SwiftUI原生的TextEditor没有直接提供区分Return键和Shift+Return组合键的API，要实现这个需求，我们可以通过封装UIKit的UITextView来实现精准的按键判断。

实现步骤 #

1. 自定义封装UITextView的SwiftUI组件
   我们创建一个CustomTextEditor，通过UIViewRepresentable桥接UIKit，利用UITextViewDelegate的回调来判断按键类型：

import SwiftUI
import UIKit

struct CustomTextEditor: UIViewRepresentable {
    @Binding var text: String
    var onReturn: () -> Void
    
    func makeUIView(context: Context) -> UITextView {
        let textView = UITextView()
        textView.delegate = context.coordinator
        textView.font = .systemFont(ofSize: 16)
        return textView
    }
    
    func updateUIView(_ uiView: UITextView, context: Context) {
        if uiView.text != text {
            uiView.text = text
        }
    }
    
    func makeCoordinator() -> Coordinator {
        Coordinator(parent: self)
    }
    
    class Coordinator: NSObject, UITextViewDelegate {
        let parent: CustomTextEditor
        
        init(parent: CustomTextEditor) {
            self.parent = parent
        }
        
        func textView(_ textView: UITextView, shouldChangeTextIn range: NSRange, replacementText text: String) -> Bool {
            guard text == "\n" else { return true }
            
            // 检查当前是否按下了Shift键
            if let event = UIApplication.shared.currentEvent, event.modifierFlags.contains(.shift) {
                // Shift+Return，允许插入换行符，不触发回调
                return true
            } else {
                // 仅Return键，触发自定义事件
                parent.onReturn()
                // 如果不需要在编辑器中保留换行，返回false；需要保留则返回true
                return false
            }
        }
    }
}

2. 在SwiftUI视图中使用自定义组件
   直接像使用原生TextEditor一样调用，传入文本绑定和Return键触发的回调：

struct ContentView: View {
    @State private var inputText = ""
    
    var body: some View {
        VStack(spacing: 20) {
            CustomTextEditor(text: $inputText) {
                // 这里写Return键触发后的逻辑，比如提交内容
                print("执行提交操作：\(inputText)")
            }
            .frame(height: 200)
            .border(.gray, cornerRadius: 8)
            
            Text("当前输入：\(inputText)")
                .font(.subheadline)
        }
        .padding()
    }
}

关键逻辑说明 #

• 在textView(_:shouldChangeTextIn:replacementText:)回调中，我们先判断替换文本是否是换行符\n（这是Return/Shift+Return都会触发的文本替换）。
• 通过UIApplication.shared.currentEvent获取当前事件，检查其modifierFlags是否包含.shift：
  • 包含则说明是Shift+Return，允许插入换行，不触发自定义事件。
  • 不包含则说明是单独的Return键，触发我们传入的onReturn回调，同时可以选择是否在编辑器中保留换行（通过返回true或false控制）。

注意事项 #

• 如果需要支持macOS，只需将UITextView替换为NSTextView，并调整对应的代理方法和事件判断逻辑。
• 若遇到外接键盘场景下currentEvent获取不到的情况，可以通过监听键盘按键事件的方式补充判断，但上述方案在绝大多数常规场景下都能正常工作。

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