UITextField 文本更改事件：正确捕捉每一次按键

UITextField 文本更改事件：每一个字符都至关重要

想象一下：您正在编写一个笔记应用、目录搜索或即时通讯工具。用户刚开始在 UITextField 中输入，您就需要立即做出响应——高亮提示、计算剩余字符或向服务器发送请求。如何捕捉文本发生变化的那个瞬间？这个问题困扰着新手甚至经验丰富的 iOS 开发者。在 Stack Overflow 上，UITextField 文本更改事件 这个话题获得了数千次浏览——这并非没有原因。

在 iOS 开发 中，至少有三种可行的方法。选择错误的方法可能会导致 bug、内存泄漏或额外多出 100 行代码。今天，我们将详细梳理所有追踪 UITextField 文本更改 的方法：从经典的委托到现代的 Combine。让我们开始吧！

为什么仅仅点击按钮是不够的？

看起来有什么复杂的？用户输入文本——然后点击“完成”或“搜索”按钮。但现代界面需要实时响应。以下是典型场景：

\n
• 自动补全（边输入边搜索）——每次按键时提示出现。
\n
• 实时验证——无需提交表单即可检查电子邮件或电话号码。
\n
• 字符计数器——例如，在 Twitter 客户端中需要显示距离限制还剩多少字符。
\n
• 动态搜索——过滤联系人列表或商品列表。
\n

在所有这些情况下，我们都需要 UITextField 文本更改事件。现在的问题是：如何在 Swift 中正确实现它？

方法 1：UITextFieldDelegate 委托——经典之作

最显而易见且可能是最流行的方法。您为文本字段指定一个委托，并实现 textField(_:shouldChangeCharactersIn:replacementString:) 方法。但有一个细微之处：此方法在文本实际更改之前被调用。它询问：“可以插入这个字符吗？”

要获取实际文本，您需要手动构建它：

class ViewController: UIViewController, UITextFieldDelegate {\n    \n    @IBOutlet weak var textField: UITextField!\n    \n    override func viewDidLoad() {\n        super.viewDidLoad()\n        textField.delegate = self\n    }\n    \n    func textField(_ textField: UITextField, shouldChangeCharactersIn range: NSRange, replacementString string: String) -> Bool {\n        let currentText = textField.text ?? ""\n        guard let stringRange = Range(range, in: currentText) else { return false }\n        let updatedText = currentText.replacingCharacters(in: stringRange, with: string)\n        \n        print("新文本: \\(updatedText)")\n        // 此处可更新 UI 或启动搜索\n        return true\n    }\n}\n

优点：

\n
• 完全控制输入——可以禁止插入特定字符。
\n
• 适用于所有 iOS 版本。
\n

缺点：

\n
• 对于简单的“捕捉更改”来说，代码过于冗长。
\n
• 需要记住 NSRange 以及转换为 Range<String.Index>。
\n
• 当通过代码设置 textField.text = "新文本" 时不会触发。
\n

如果您需要验证输入（例如，在电话号码字段中禁止输入字母），这种方法非常合适。但对于简单的更改追踪，有更优雅的选择。

方法 2：Target-Action (UIControl.Event.editingChanged)——简单可靠

第二种方法是为 .editingChanged 事件添加目标和动作。它在每次文本更改之后触发，代码看起来非常简洁：