InputType — co to jest, atrybuty wprowadzania i ich konfiguracja w Androidzie

Czym jest InputType w Androidzie

InputType — to stała całkowitoliczbowa (Int), która koduje tryb wprowadzania dla pola tekstowego. W Androidzie jest zdefiniowana w klasie android.text.InputType. Wartość InputType składa się z dwóch części: klasy wprowadzania (bity 0–4) i modyfikatorów (bity 5–31). Klasa wprowadzania określa podstawowy typ danych — tekst, liczba, telefon, data. Modyfikatory określają zachowanie w ramach wybranej klasy — na przykład dla klasy tekstowej można włączyć autokorektę, wielkie litery lub wprowadzanie wieloliniowe.

Mechanizm InputType działa na trzech poziomach: na poziomie frameworka Androida określa, który InputConnection zostanie utworzony (połączenie między EditText a IME); na poziomie IME (klawiatury) wskazuje, które znaki pokazywać i jak przetwarzać wprowadzanie; na poziomie aplikacji filtruje znaki przez InputFilter wbudowany w EditText. Według Android Source Code (AOSP, 2026), maska bitowa jest przetwarzana w metodzie TextView.getInputType(), która zwraca bieżącą wartość, oraz setInputType(), która rekonfiguruje wewnętrzne filtry i połączenie z IME.

Ważna cecha InputType — nie można go odczytać z innego procesu ze względów bezpieczeństwa. Zapobiega to kradzieży danych poprzez dostęp do typu wprowadzania (na przykład określenie, czy pole jest hasłem). Przy próbie odczytu InputType z innej aplikacji zwracane jest TYPE_CLASS_TEXT domyślnie.

// Podstawowe stałe InputType
InputType.TYPE_CLASS_TEXT       // 0x0001 = 1
InputType.TYPE_CLASS_NUMBER     // 0x0002 = 2
InputType.TYPE_CLASS_PHONE      // 0x0003 = 3
InputType.TYPE_CLASS_DATETIME   // 0x0004 = 4

// Maska do wyodrębniania klasy
InputType.TYPE_MASK_CLASS       // 0x0000000F

Klasy InputType: TEXT, NUMBER, PHONE, DATETIME

W Androidzie zdefiniowano cztery podstawowe klasy InputType. Każda klasa odpowiada określonej kategorii danych i aktywuje odpowiedni typ klawiatury. Klasa jest wskazywana w bitach 0–4 maski bitowej i może być wyodrębniona przez maskę TYPE_MASK_CLASS (0x0F).

TYPE_CLASS_DATETIME jest rzadko używany bezpośrednio — zazwyczaj do wprowadzania daty stosuje się DatePicker lub DatePickerDialog, a nie pole tekstowe. Jednak w niektórych scenariuszach (szybkie ręczne wprowadzanie daty) ta klasa może być przydatna. Nie ma ona specjalistycznej klawiatury i zazwyczaj wyświetla klawiaturę numeryczną.

Każda klasa wprowadzania może być łączona z wariacjami (variation) — podtypami wskazanymi w bitach 5–7. Na przykład TYPE_TEXT_VARIATION_PASSWORD (bit 5) dodaje do klasy TEXT ukryte wprowadzanie. Bity wariacji: 0x000000E0 (maska TYPE_MASK_VARIATION).

Flagi-modyfikatory InputType

Flagi-modyfikatory InputType (bity 8–31) dodają dodatkowe możliwości do podstawowej klasy. Nie zmieniają one typu klawiatury, ale modyfikują zachowanie wprowadzania. Flagii są specyficzne dla każdej klasy — flagi dla TEXT nie działają z NUMBER i odwrotnie. Poniżej wymieniono główne modyfikatory dla każdej klasy.

Flagi dla TEXT

• TYPE_TEXT_FLAG_CAP_CHARACTERS — wszystkie litery wielkie.
• TYPE_TEXT_FLAG_CAP_WORDS — każde słowo z wielkiej litery.
• TYPE_TEXT_FLAG_CAP_SENTENCES — wielka litera na początku zdania (domyślnie).
• TYPE_TEXT_FLAG_AUTO_CORRECT — automatyczna korekta literówek.
• TYPE_TEXT_FLAG_AUTO_COMPLETE — autouzupełnianie (dla AutoCompleteTextView).
• TYPE_TEXT_FLAG_MULTI_LINE — wprowadzanie wieloliniowe.
• TYPE_TEXT_FLAG_NO_SUGGESTIONS — wyłączenie podpowiedzi.

Flagi dla NUMBER

• TYPE_NUMBER_FLAG_SIGNED — zezwala na liczby ujemne (znak minusa).
• TYPE_NUMBER_FLAG_DECIMAL — zezwala na przecinek dziesiętny.

Według Android Developers Documentation (2026), flagi dla różnych klas nie nakładają się — próba użycia flagi TEXT z NUMBER zostanie zignorowana. Do sprawdzenia ustawionej flagi używa się bitowego AND: (inputType and FLAG) != 0.

Kombinacje InputType: przykłady dla różnych scenariuszy

Prawidłowa kombinacja InputType z klasami i flagami to klucz do tworzenia wygodnych formularzy. Rozważmy typowe scenariusze i odpowiadające im konfiguracje InputType. Każdy scenariusz optymalizuje wprowadzanie dla konkretnego typu danych, czyniąc formularz intuicyjnym i przyspieszając jego wypełnianie.

// Kombinacja dla pola ceny
editText.inputType = InputType.TYPE_CLASS_NUMBER or
    InputType.TYPE_NUMBER_FLAG_DECIMAL

// Kombinacja dla pola komentarza
editText.inputType = InputType.TYPE_CLASS_TEXT or
    InputType.TYPE_TEXT_FLAG_CAP_SENTENCES or
    InputType.TYPE_TEXT_FLAG_MULTI_LINE

Programowa praca z InputType

Ustawienie InputType programowo przez setInputType() nadpisuje poprzednią wartość. Jeśli trzeba zmienić tylko część maski (na przykład dodać flagę), należy zachować bieżącą wartość, zmienić ją i zastosować ponownie. Każde wywołanie setInputType() rekonfiguruje wewnętrzne filtry EditText.

Metoda setRawInputType() różni się od setInputType tym, że nie powoduje rekonfiguracji filtrów i podpowiedzi. Jest używana do tymczasowej zmiany InputType bez pełnego przeładowania stanu EditText. Po wywołaniu setInputType() zaleca się ponowne uruchomienie IME, aby klawiatura została zaktualizowana.

Przełączanie trybów

// Przełączanie między hasłem a widocznym tekstem
fun togglePasswordVisibility(editText: EditText) {
    val currentType = editText.inputType
    val isPassword = (currentType and
        InputType.TYPE_TEXT_VARIATION_PASSWORD) != 0

    editText.inputType = if (isPassword) {
        InputType.TYPE_CLASS_TEXT or
            InputType.TYPE_TEXT_VARIATION_VISIBLE_PASSWORD
    } else {
        InputType.TYPE_CLASS_TEXT or
            InputType.TYPE_TEXT_VARIATION_PASSWORD
    }

    // Zachowaj pozycję kursora
    val cursorPos = editText.selectionStart
    editText.setSelection(cursorPos)
}

Wyodrębnianie klasy i wariacji

// Pobierz klasę wprowadzania
fun getInputClass(inputType: Int): Int {
    return inputType and InputType.TYPE_MASK_CLASS
}

// Pobierz wariację wprowadzania
fun getInputVariation(inputType: Int): Int {
    return inputType and InputType.TYPE_MASK_VARIATION
}

// Sprawdź, czy pole hasła
fun isPasswordField(editText: EditText): Boolean {
    return (editText.inputType and
        InputType.TYPE_TEXT_VARIATION_PASSWORD) != 0
}

Najlepsze praktyki wyboru InputType

Prawidłowy wybór InputType to nie tylko UX, ale także bezpieczeństwo i poprawność danych. Główne zalecenia obejmują: zawsze określać jawny InputType dla każdego EditText; używać najbardziej konkretnej klasy wprowadzania; nie łączyć flag z różnych klas; dla pól z wrażliwymi danymi używać wariacji PASSWORD; dla pól wyszukiwania używać imeOptions=„actionSearch”.

InputType wpływa również na działanie usług ułatwień dostępu (Accessibility). Pola z typem textPassword otrzymują dodatkową ochronę przed czytnikami ekranu — nie odczytują one wprowadzanych znaków na głos. Dla pól z textEmailAddress Screen Reader informuje użytkownika, że pole jest przeznaczone do email, i oferuje odpowiednie podpowiedzi.

• Jawność — zawsze jawnie ustawiaj InputType, nie polegaj na wartości domyślnej (textMultiLine).
• Specyficzność — używaj najbardziej konkretnego typu: textEmailAddress, a nie text dla email.
• Bezpieczeństwo — dla haseł, PIN i danych kart używaj wariacji PASSWORD.
• Autouzupełnianie — łącz InputType z autofillHints dla wsparcia menedżerów haseł.
• Testowanie — sprawdzaj zachowanie na różnych klawiaturach (Gboard, SwiftKey, Samsung Keyboard).

Według Material Design Guidelines (2025), InputType powinien odpowiadać typowi danych wprowadzanych przez użytkownika. Nieprawidłowy InputType nie tylko spowalnia wprowadzanie, ale może również prowadzić do błędów: na przykład, jeśli do wprowadzania numeru telefonu pozostawić textMultiLine, klawiatura nie pokaże bloku numerycznego, a użytkownik będzie zmuszony ręcznie przełączać układ za każdym razem.