UITextField字符超限提示、粘贴截断与光标插入替换实现

现有实现的核心逻辑缺陷 #

之前的代码存在两个本质性问题：

• 长度计算完全忽略了代理方法传入的range参数：没有考虑当前文本中被选中、即将被替换删除的字符长度，只要在文本中间插入内容，计算出的总长度就会严重失真，容易出现误判
• 触发超限时直接返回false拦截全部输入，没有做自动截断适配，超长粘贴时用户完全无法输入任何内容，既不符合截断留用的要求，中间插入场景的冗余替换逻辑也完全没有覆盖

核心实现逻辑 #

针对两个待落地的需求，统一基于代理方法的原生流程处理，不需要额外监听粘贴事件：

1. 正确计算替换后的文本长度：用NSString.replacingCharacters(in:with:)方法模拟系统的文本替换逻辑，把原文本中选中range的部分替换为当前输入/粘贴的字符串，得到真实的最终文本长度，避免计算偏差
2. 超限时自动截断处理：当计算出的最终长度超过设定上限时，先触发超限提示，再从新输入/粘贴的字符串中截掉超出上限的冗余部分，手动把截断后的内容替换到选中范围，保证最终文本长度刚好卡在设定上限，不会超长
3. 复用系统原有输入流程：正常长度内的输入直接走系统默认的替换逻辑，不做额外干预，只有超限时才手动接管文本设置

完整可运行代码 #

通用处理方法 #

private func showLimitExceededAlert() {
    let alert = UIAlertController(
        title: nil,
        message: "已超出最大字符数限制",
        preferredStyle: .alert
    )
    present(alert, animated: true)
    DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
        alert.dismiss(animated: true)
    }
}

private func applyCharacterLimit(
    textField: UITextField,
    range: NSRange,
    replacementString string: String,
    limit: Int
) {
    guard let currentText = textField.text as NSString? else { return }
    let finalText = currentText.replacingCharacters(in: range, with: string)
    
    // 长度未超，直接放行走系统默认逻辑
    guard finalText.count > limit else { return }
    
    // 触发超限提示
    showLimitExceededAlert()
    
    // 计算超出长度，自动截断输入内容
    let overflowLength = finalText.count - limit
    let trimmedInput = string.prefix(string.count - overflowLength)
    // 手动替换截断后的文本
    let trimmedFinalText = currentText.replacingCharacters(in: range, with: String(trimmedInput))
    textField.text = trimmedFinalText
}

UITextField 代理对接 #

func textField(_ textField: UITextField, shouldChangeCharactersIn range: NSRange, replacementString string: String) -> Bool {
    let limit = 5
    // 先执行限制处理逻辑
    applyCharacterLimit(
        textField: textField,
        range: range,
        replacementString: string,
        limit: limit
    )
    // 判断是否需要阻止系统默认替换（超限时我们已经手动设置文本，需要拦截）
    guard let currentText = textField.text as NSString? else { return true }
    let finalText = currentText.replacingCharacters(in: range, with: string)
    return finalText.count <= limit
}

场景适配说明 #

• 粘贴超长内容场景：UIKit的全局粘贴操作会自动传入完整的粘贴字符串作为replacementString走代理流程，不需要额外注册粘贴监听，会自动完成截断和超限提示
• 光标在文本中间插入场景：不管是在任意位置插入、还是选中已有文本做替换，都会通过range参数计算真实的最终长度，超出部分会从新输入的内容里自动裁掉，保证最终文本长度不超过上限
• 满额状态输入场景：当文本已经达到上限时，在任意位置输入/粘贴内容，都会自动裁掉所有超出的部分，保持原有文本长度不变

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