SwiftUI TextField的textInputAutocapitalization修饰符iOS16兼容问题

你遇到的问题出在iOS 16及更早版本中，TextField的value绑定结合自定义ParseableFormatStyle与textInputAutocapitalization修饰符的兼容性冲突。

具体原因： #

在iOS 16及以下系统中，当同时使用自定义ParseableFormatStyle（负责输入转大写）和textInputAutocapitalization(.characters)（系统层面自动大写）时，两者会在TextField的输入处理流程中互相干扰：

1. 用户输入超过9字符后，onChange触发截断文本到9位；
2. 截断后的文本会被自定义格式器的parse方法再次转大写，同时系统的自动大写逻辑也会介入；
3. 这种重复的状态更新会导致TextField内部状态混乱，最终出现无响应的情况。
   而iOS 17对TextField的格式器与自动输入修饰符的交互逻辑做了优化，因此没有出现该问题。

修复方案： #

方案1：替换自定义格式器，使用原生修饰符（推荐）

直接用SwiftUI原生的textCase(.uppercase)替代自定义格式器，同时保留textInputAutocapitalization(.characters)，这种方式在全版本iOS中兼容性更好：

import SwiftUI

struct ContentView: View {
    @FocusState var isFocused: Bool
    let length = 9 // 修正拼写错误 lengh -> length
    @State var text = ""
    
    var body: some View {
        VStack {
            HStack {
                TextField("write text here...", text: $text)
                    .focused($isFocused)
                    .textCase(.uppercase) // 原生大写修饰符
                    .textInputAutocapitalization(.characters)
            }
            .border(.black)
        }
        .padding()
        .onChange(of: text) { newValue in
            if newValue.count > length {
                text = String(newValue.prefix(length))
            }
        }
    }
}

#Preview {
    ContentView()
}

方案2：保留自定义格式器，移除textInputAutocapitalization

如果必须使用自定义格式器，去掉textInputAutocapitalization(.characters)，仅靠格式器处理大写，避免两者冲突：

import SwiftUI

struct ContentView: View {
    @FocusState var isFocused: Bool
    let length = 9 // 修正拼写错误
    @State var text = ""
    
    var body: some View {
        VStack {
            HStack {
                TextField("write text here...",
                          value: $text,
                          format: .defaultUppercased)
                .focused($isFocused)
                // 移除textInputAutocapitalization修饰符
            }
            .border(.black)
        }
        .padding()
        .onChange(of: text) { newValue in
            if newValue.count > length {
                text = String(newValue.prefix(length))
            }
        }
    }
}

// 以下自定义格式器代码保留不变
public struct DefaultUppercasedFormatStyle: ParseableFormatStyle {
    public init() {}
}

extension DefaultUppercasedFormatStyle {
    public var parseStrategy: Self { self }
    public func format(_ value: String) -> String { value }
}

extension DefaultUppercasedFormatStyle: ParseStrategy {
    public func parse(_ value: String) -> String { value.uppercased() }
}

extension FormatStyle where Self == DefaultUppercasedFormatStyle {
    public static var defaultUppercased: Self { Self() }
}

#Preview {
    ContentView()
}

额外提示： #

代码中lengh是拼写错误，建议修正为length，避免后续维护出现问题。

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