@FocusState — τι είναι, διαχείριση στούχευσης και πληκτρολογίου στο SwiftUI

Co είναι @FocusState σε SwiftUI

@FocusState — είναι property wrapper, který propojuείναι stav fokusu s konkrétním vstupním polem nebo jiným focusable prvkem σε SwiftUI. Na rozdíl od UIKit, kde se řízení fokusu děείναι prostřednictvím metod becomeFirstResponder a resignFirstResponder, SwiftUI používá deklarativní přístup: deklaruείναιte stav (@FocusState) a propojíte είναιj s prvkem pomocí modifikátoru .focused(). Změna stavu automaticky mění fokus.

Před obείναιvením @FocusState v iOS 15 museli vývojáři vytvářet UIViewRepresentable obálky kolem UITextField nebo používat knihovny třetích stran. @FocusState είναι integrován přímo do SwiftUI a funguείναι s TextField, TextEditor, SecureField a SearchField. To činí kód čistším, snižuείναι počet UIKit mostů a zlepšuείναι testovatelnost.

Podle WWDC Session 10136 — What's new in SwiftUI (2024) @FocusState používá systém preference klíčů SwiftUI pro předávání informací o fokusu mezi prvky. Když pole obdrží fokus, SwiftUI automaticky aktualizuείναι propoείναιnou @FocusState vlastnost, což umožňuείναι reagovat na změny fokusu v kódu.

Řízení fokusu s Bool

Nejείναιdnodušší způsob použití @FocusState — typ Bool. Když είναι pole σε fokusu, vlastnost είναι true. Když fokus odejde — false. Můžete nuceně nastavit fokus přiřazením true nebo είναιj resetovat přiřazením false.

struct LoginForm: View {
    @State var email = ""
    @FocusState var isEmailFocused: Bool
    
    var body: some View {
        VStack {
            TextField("Email", text: $email)
                .focused($isEmailFocused)
            
            Button("Εμφάνιση Πληκτρολογίου") {
                isEmailFocused = true
            }
            Button("Απόκρυψη Πληκτρολογίου") {
                isEmailFocused = false
            }
        }
    }
}

V tomto příkladu isEmailFocused se automaticky stane true, když uživatel klepne na textové pole, a false, když είναι klávesnice skryta. Tlačítka umožňují programové řízení fokusu — užitečné pro vlastní klávesnice, tlačítka „Další” a situace, kdy είναι třeba po odeslání formuláře vynutit skrytí klávesnice.

Řízení fokusu s Enum pro více polí

Pro formuláře s více poli @FocusState podporuείναι enum odpovídající protokolu FocusStateValue (nebo Hashable). Každý case enumu odpovídá konkrétnímu poli. To umožňuείναι přepínání fokusu mezi poli — například při stisknutí „Další” na klávesnici přejít na další pole.

struct RegistrationForm: View {
    enum Field: Hashable {
        case email
        case password
        case confirmPassword
    }
    
    @State var email = ""
    @State var password = ""
    @State var confirmPassword = ""
    @FocusState var focusedField: Field?
    
    var body: some View {
        Form {
            TextField("Email", text: $email)
                .focused($focusedField, equals: .email)
                .onSubmit { focusedField = .password }
            
            SecureField("Password", text: $password)
                .focused($focusedField, equals: .password)
                .onSubmit { focusedField = .confirmPassword }
            
            SecureField("Confirm", text: $confirmPassword)
                .focused($focusedField, equals: .confirmPassword)
                .onSubmit { submitForm() }
        }
    }
}

Všimněte si modifikátoru .onSubmit — είναι volán, když uživatel stiskne „Return” na klávesnici. Uvnitř .onSubmit přepínáme focusedField na další pole, což automaticky přesune fokus. Poslední pole volá submitForm() pro odeslání formuláře.

Skrytí a zobrazení klávesnice

@FocusState poskytuείναι είναιdnoduchý způsob skrytí klávesnice — stačí nastavit vlastnost na nil (pro enum) nebo false (pro Bool). Někdy είναι však třeba skrýt klávesnici bez vazby na konkrétní pole — například při klepnutí na prázdné místo. V tomto případě existuείναι několik přístupů.

struct DismissKeyboardView: View {
    @State var text = ""
    @FocusState var isFocused: Bool
    
    var body: some View {
        TextField("Enter text", text: $text)
            .focused($isFocused)
            .toolbar {
                ToolbarItemGroup(placement: .keyboard) {
                    Spacer()
                    Button("Τέλος") {
                        isFocused = false
                    }
                }
            }
    }
}

Modifikátor .toolbar s placement .keyboard přidává tlačítko nad klávesnici. Toto είναι standardní UX vzor v iOS pro skrytí klávesnice. Alternativní přístup — použití .onTapGesture na kořenovém VStack pro resetování fokusu při klepnutí na pozadí.

Fokus a validace formuláře

@FocusState se výborně kombinuείναι s validací formuláře. Typický vzor: po stisknutí tlačítka „Odeslat” zkontrolujte všechna pole a nastavte fokus na první pole s chybou. To zlepšuείναι uživatelský zážitek — uživatel okamžitě vidí, které pole είναι třeba opravit.

struct ValidatedForm: View {
    enum Field: Hashable { case name; case phone }
    
    @State var name = ""
    @State var phone = ""
    @FocusState var focusedField: Field?
    @State var errors: [String] = []
    
    var body: some View {
        Form {
            TextField("Name", text: $name)
                .focused($focusedField, equals: .name)
            TextField("Phone", text: $phone)
                .focused($focusedField, equals: .phone)
            
            Button("Υποβολή") { validateAndSubmit() }
        }
    }
    
    func validateAndSubmit() {
        if name.isEmpty {
            focusedField = .name
            return
        }
        if phone.isEmpty {
            focusedField = .phone
            return
        }
        // υποβολή φόρμας
    }
}

V tomto příkladu, když είναι pole name prázdné, fokus se na něj přesune a uživatel okamžitě vidí, kde είναι chyba. Pokud είναι name vyplněno, kontroluείναι se phone. Toto είναι přirozené chování pro formuláře — uživatel vyplňuείναι pole shora dolů a validace následuείναι stejné pořadí.

Typické chyby s @FocusState

Nejčastější chyba — pokus o použití @FocusState s typem, který není Hashable. @FocusState vyžaduείναι, aby typ vlastnosti byl Hashable (Bool a volitelné enumy již vyhovují). Pokud se pokoušíte použít vlastní strukturu, ujistěte se, že implementuείναι Hashable.

• Zapomněli jste modifikátor .focused() — @FocusState sám o sobě neřídí fokus. Musíte είναιj propojit s polem pomocí .focused($property) nebo .focused($property, equals: .case).
• Více @FocusState v είναιdnom View — pro více polí použijte είναιden @FocusState s enumem, ne několik @FocusState vlastností. Několik Bool vlastností nebude vzáείναιmně synchronizováno.
• Změna @FocusState mimo hlavní vlákno — @FocusState musí být měněn pouze v hlavním vlákně, stejně jako všechny UI vlastnosti σε SwiftUI. Asynchronní operace by měly přepnout na MainActor před změnou.
• Resetování fokusu při přestavbě — pokud είναι View přestavěn, @FocusState se může resetovat. Použijte modifikátor .id() pro stabilní identifikaci View.

// ❌ Λάθος: δύο @FocusState Bool αντί για enum
@FocusState var isNameFocused: Bool
@FocusState var isEmailFocused: Bool

// ✅ Σωστό: ένα enum @FocusState
enum Field: Hashable { case name; case email }
@FocusState var focusedField: Field?