UITextField光标在起始位置按删除键清空内容的原因及修复方案

问题描述 #

当光标处于UITextField的起始位置时，按下一次删除键会清空整个输入框。请问该问题的成因是什么？该如何修复？我已尝试多种解决方案但均无效，该行为是iOS的默认特性吗？

用户提供的自定义代码 #

extension LockVC : UITextFieldDelegate {
    func textFieldShouldReturn(_ textField: UITextField) -> Bool {
        textField.resignFirstResponder()
        return true
    }
    
    func textFieldDidBeginEditing(_ textField: UITextField) {
        // Reset the flag variable when editing begins
        hasBeenEdited = false
    }

    func textFieldDidEndEditing(_ textField: UITextField) {
        // Reset the flag variable when editing ends
        hasBeenEdited = false
    }
    
// When the user changes the text in the text field, limit the length of the text and handle deletion and insertion of characters
    func textField(_ textField: UITextField, shouldChangeCharactersIn range: NSRange,     replacementString string: String) -> Bool {
        let MAX_LENGTH = 25
        
        // Ensure that there is a selected text range in the text field
        guard let selectedRange = textField.selectedTextRange else {
            return false
        }
        
        // Check if there is any selected text to delete
        if selectedRange.start != selectedRange.end {
            textField.deleteBackward()
            return false
        }
        
        // If the delete key is pressed, handle deletion of text
        if string.isEmpty && range.length == 1 {
            // Get cursor position
            guard let cursorPosition = textField.selectedTextRange?.start else {
                return false
            }
            
            // If cursor is at start and text field has been previously edited, do not allow deletion
            if cursorPosition == textField.beginningOfDocument && hasBeenEdited {
                // If the cursor is at the beginning of the textfield, do not allow deletion
                if range.location == 0 {
                    return false
                }
            }
            
            // Delete only one character at cursor position
            if let cursorPosition = textField.selectedTextRange?.start,
               cursorPosition != textField.beginningOfDocument {
                if let deletedRange = textField.textRange(from: cursorPosition, to: textField.position(from: cursorPosition, offset: -1)!) {
                    textField.replace(deletedRange, withText: "")
                }
                return false
            }
            return false
        }
        
        // Insertion
        if let text = textField.text, !string.isEmpty || !text.isEmpty {
            let currentText = text as NSString
            let newText = currentText.replacingCharacters(in: range, with: string)
            
            // If new text exceeds max length, show alert and do not allow insertion
            if newText.count > MAX_LENGTH {
                //self.showToast(message: "Password must be \(MAX_LENGTH) characters or less.", font: .systemFont(ofSize: 12.0))
                let alert = UIAlertController(title: "Password must be \(MAX_LENGTH) characters or less.", message: "", preferredStyle: .alert)
                alert.addAction(UIAlertAction(title: "OK", style: .default, handler: nil))
                present(alert, animated: true, completion: nil)
                return false
            }
            
            // Insert only one character at cursor position
            if let cursorPosition = textField.selectedTextRange?.start {
                if let insertionRange = textField.textRange(from: cursorPosition, to: cursorPosition) {
                    textField.replace(insertionRange, withText: string)
                }
            }
        }
        
        // Set the flag variable to true after first edit
        if !hasBeenEdited {
            hasBeenEdited = true
        }
        
        return false
    }
}

成因分析 #

这不是iOS的默认特性，默认情况下光标在UITextField起始位置按删除键不会有任何操作。问题出在你自定义的代理方法textField(_:shouldChangeCharactersIn:replacementString:)中：

1. 手动干预文本修改的逻辑（直接调用deleteBackward()、replace方法），导致文本状态和光标位置出现不一致的异常
2. 删除逻辑分支覆盖不全：当光标在起始位置且hasBeenEdited为false时（比如刚进入编辑状态还未输入内容），代码没有正确拦截删除操作，最终触发了异常的全删行为
3. 始终返回false，完全绕过了系统的默认文本修改逻辑，手动处理文本的方式存在漏洞

修复方案 #

核心思路是：尽量依赖系统默认的文本处理逻辑，只在需要时做限制，避免手动修改文本导致的状态混乱。修改后的代理方法如下：

extension LockVC : UITextFieldDelegate {
    func textFieldShouldReturn(_ textField: UITextField) -> Bool {
        textField.resignFirstResponder()
        return true
    }
    
    func textFieldDidBeginEditing(_ textField: UITextField) {
        hasBeenEdited = false
    }

    func textFieldDidEndEditing(_ textField: UITextField) {
        hasBeenEdited = false
    }
    
    func textField(_ textField: UITextField, shouldChangeCharactersIn range: NSRange, replacementString string: String) -> Bool {
        let MAX_LENGTH = 25
        
        // 处理删除键：光标在起始位置时禁止删除
        if string.isEmpty {
            guard let cursorPosition = textField.selectedTextRange?.start else {
                return false
            }
            if cursorPosition == textField.beginningOfDocument {
                return false
            }
            // 其他情况允许系统默认删除单个字符
            return true
        }
        
        // 处理插入操作，限制文本长度
        let currentText = textField.text ?? ""
        let newText = (currentText as NSString).replacingCharacters(in: range, with: string)
        
        if newText.count > MAX_LENGTH {
            let alert = UIAlertController(title: "密码不能超过\(MAX_LENGTH)个字符", message: "", preferredStyle: .alert)
            alert.addAction(UIAlertAction(title: "确定", style: .default))
            present(alert, animated: true)
            return false
        }
        
        // 更新编辑状态标记
        if !hasBeenEdited {
            hasBeenEdited = true
        }
        
        return true
    }
}

关键修改点 #

• 移除了所有手动修改文本的代码，让系统处理默认的文本删除、插入逻辑，避免状态不一致
• 简化删除键判断逻辑：光标在起始位置时直接返回false，禁止删除操作；其他情况允许系统默认删除单个字符
• 保留了文本长度限制的逻辑，但使用系统默认的文本替换方式，更可靠
• 仅在必要时返回false，其余情况返回true让系统处理默认流程

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