SwiftUI如何通过Toggle开关动态切换默认/数字键盘类型

问题场景 #

使用SwiftUI开发iOS应用设置页的密码二次确认功能时，在键盘工具栏内置ToolbarItemGroup承载Toggle开关，用于切换「数字密码/复杂密码」输入模式，绑定viewModel.isAlphaNumeric布尔状态动态修改输入框的keyboardType参数。但实际运行时切换Toggle开关，键盘不会实时更新类型，只有切换输入框焦点后才会加载正确的键盘样式。
原有问题代码如下：

SecureField("Master Password", text: $viewModel.password)
    .modifier(NoAutocapitalizationViewModifier())
    .padding()
    .overlay(RoundedRectangle(cornerRadius: 10.0).strokeBorder(Color.blue, style: StrokeStyle(lineWidth: 2.0)))
    .padding([.horizontal])
    .frame(maxWidth: .infinity)
    .keyboardType(viewModel.isAlphaNumeric ? .default : .numberPad)
    .toolbar {
        ToolbarItemGroup(placement: .keyboard) {
            Spacer()
            
            Toggle("Complex Password", isOn: $viewModel.isAlphaNumeric)
                .toggleStyle(.switch)
        }
    }

SecureField("Confirm Password", text: $viewModel.confirmPassword)
    .modifier(NoAutocapitalizationViewModifier())
    .padding()
    .overlay(RoundedRectangle(cornerRadius: 10.0).strokeBorder(Color.blue, style: StrokeStyle(lineWidth: 2.0)))
    .padding([.horizontal])
    .frame(maxWidth: .infinity)
    .keyboardType(viewModel.isAlphaNumeric ? .default : .numberPad)
    .toolbar {
        ToolbarItemGroup(placement: .keyboard) {
            Spacer()
            
            Toggle("Complex Password", isOn: $viewModel.isAlphaNumeric)
                .toggleStyle(.switch)
        }
    }

失效原因 #

• 输入框已经成为第一响应者（键盘处于弹出激活状态）时，SwiftUI不会主动触发键盘配置重载，只有输入框重新获取第一响应者身份时，才会读取最新的keyboardType参数更新键盘样式，这是底层UIKit输入组件的默认行为。
• 原有代码给两个输入框重复绑定了完全相同的Toolbar配置，会导致开关状态触发时存在冗余渲染问题。

修复方案 #

• 新增FocusState枚举，标记当前处于激活状态的输入框
• 监听viewModel.isAlphaNumeric的状态变化，值变更时临时注销当前输入框的第一响应者身份，在下一个主线程周期恢复焦点，强制键盘重新加载最新配置
• 将两个输入框重复的Toolbar配置抽离到父容器，避免冗余渲染

修正后可运行代码 #

// 定义密码输入框的焦点类型枚举
enum PasswordField: Hashable {
    case master
    case confirm
}

struct PasswordSettingView: View {
    @StateObject private var viewModel = PasswordViewModel()
    // 绑定当前输入框焦点状态
    @FocusState private var focusedField: PasswordField?
    
    var body: some View {
        VStack(spacing: 20) {
            SecureField("Master Password", text: $viewModel.password)
                .modifier(NoAutocapitalizationViewModifier())
                .padding()
                .overlay(RoundedRectangle(cornerRadius: 10.0).strokeBorder(Color.blue, style: StrokeStyle(lineWidth: 2.0)))
                .padding([.horizontal])
                .frame(maxWidth: .infinity)
                .keyboardType(viewModel.isAlphaNumeric ? .default : .numberPad)
                .focused($focusedField, equals: .master)
            
            SecureField("Confirm Password", text: $viewModel.confirmPassword)
                .modifier(NoAutocapitalizationViewModifier())
                .padding()
                .overlay(RoundedRectangle(cornerRadius: 10.0).strokeBorder(Color.blue, style: StrokeStyle(lineWidth: 2.0)))
                .padding([.horizontal])
                .frame(maxWidth: .infinity)
                .keyboardType(viewModel.isAlphaNumeric ? .default : .numberPad)
                .focused($focusedField, equals: .confirm)
        }
        // 统一配置键盘工具栏，无需给每个输入框重复添加
        .toolbar {
            ToolbarItemGroup(placement: .keyboard) {
                Spacer()
                Toggle("Complex Password", isOn: $viewModel.isAlphaNumeric)
                    .toggleStyle(.switch)
            }
        }
        // 监听密码模式切换事件，触发键盘配置刷新
        .onChange(of: viewModel.isAlphaNumeric) { _ in
            guard let currentActiveField = focusedField else { return }
            // 临时注销当前输入框焦点
            focusedField = nil
            // 在下一个主线程循环恢复焦点，触发键盘重载
            DispatchQueue.main.async {
                focusedField = currentActiveField
            }
        }
    }
}

方案对比 #

• 上述焦点临时切换的方案不会清空已输入的密码内容，切换过程无肉眼可见的键盘抖动，输入体验流畅，是优先推荐的实现方式。
• 也可以通过给输入框添加.id(viewModel.isAlphaNumeric)修饰符，强制在模式切换时重建输入框组件实现键盘刷新，但这种方式会导致键盘出现明显的收起再弹起动画，体验较差，不推荐使用。

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