如何基于IQKeyboard Manager实现TableView中TextField垂直切换

1. 禁用IQKeyboardManager的自动切换逻辑 #

先关掉IQKeyboardManager默认的水平方向自动切换，避免和自定义逻辑冲突：

IQKeyboardManager.shared.enableAutoToolbar = false
IQKeyboardManager.shared.shouldResignOnTouchOutside = true // 保留点击外部收起键盘的功能，可选

2. 给TextField标记行列信息 #

自定义UITextField子类，添加行列属性用来定位当前输入框：

class GridTextField: UITextField {
    var row: Int = 0
    var column: Int = 0
}

在TableView的cellForRowAt方法中，给每个输入框绑定对应的行列值：

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    let cell = tableView.dequeueReusableCell(withIdentifier: "GridCell", for: indexPath) as! GridCell
    // 假设cell内的textFields是存储输入框的数组
    for (col, textField) in cell.textFields.enumerated() {
        guard let gridTextField = textField as? GridTextField else { continue }
        gridTextField.row = indexPath.row
        gridTextField.column = col
        gridTextField.delegate = self
    }
    return cell
}

3. 实现垂直切换核心逻辑 #

通过UITextField代理方法处理切换，同时兼容蓝牙设备触发的Tab事件：

extension YourViewController: UITextFieldDelegate {
    func textFieldShouldReturn(_ textField: UITextField) -> Bool {
        guard let currentTF = textField as? GridTextField else { return true }
        let totalRows = tableView.numberOfRows(inSection: 0)
        let totalColumns = 5 // 替换成你的实际总列数
        
        var nextRow = currentTF.row + 1
        var nextCol = currentTF.column
        
        // 到达最后一行时，回到第一行并切换到下一列
        if nextRow >= totalRows {
            nextRow = 0
            nextCol += 1
            // 列也到末尾时，回到第一列（可选，根据需求调整）
            if nextCol >= totalColumns {
                nextCol = 0
            }
        }
        
        // 处理cell复用导致的不可见情况，先滚动到目标行
        let nextIndexPath = IndexPath(row: nextRow, section: 0)
        tableView.scrollToRow(at: nextIndexPath, at: .none, animated: false)
        
        DispatchQueue.main.async {
            guard let targetCell = self.tableView.cellForRow(at: nextIndexPath) as? GridCell else { return }
            guard let targetTF = targetCell.textFields[nextCol] as? GridTextField else { return }
            targetTF.becomeFirstResponder()
        }
        return false
    }
    
    // 如果蓝牙设备粘贴后自动结束编辑，通过此方法触发切换
    func textFieldDidEndEditing(_ textField: UITextField) {
        _ = textFieldShouldReturn(textField)
    }
}

4. 监听Tab键事件（适配蓝牙设备模拟Tab的场景） #

添加键盘命令监听Tab键，触发自定义切换逻辑：

override var keyCommands: [UIKeyCommand]? {
    return [
        UIKeyCommand(input: "\t", modifierFlags: [], action: #selector(handleTabTrigger))
    ]
}

@objc private func handleTabTrigger() {
    guard let currentTF = UIResponder.currentFirstResponder() as? GridTextField else { return }
    _ = textFieldShouldReturn(currentTF)
}

// 获取当前第一响应者的扩展
extension UIResponder {
    static func currentFirstResponder() -> UIResponder? {
        _currentFirstResponder = nil
        UIApplication.shared.sendAction(#selector(findFirstResponder), to: nil, from: nil, for: nil)
        return _currentFirstResponder
    }
    
    private static weak var _currentFirstResponder: UIResponder?
    
    @objc private func findFirstResponder() {
        UIResponder._currentFirstResponder = self
    }
}

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