Keyboard Type — какво е, типове клавиатура и настройка на въвеждане в Android

Какво е Keyboard Type в Android

Keyboard Type се определя от стойността на атрибута android:inputType в XML или от програмното извикване setInputType() в код. InputType представлява битова маска, където класът на въвеждане (клас) се комбинира с модифициращи флагове. Базови класове: TYPE_CLASS_TEXT за текст, TYPE_CLASS_NUMBER за числа, TYPE_CLASS_PHONE за телефони, TYPE_CLASS_DATETIME за дати и време.

Всеки Keyboard Type влияе на три аспекта: оформлението на виртуалната клавиатура (кои символи са видими на основния екран), филтрирането на въведените символи (кои символи са разрешени) и поведението на автоматична корекция/автоматично довършване. Например, number клавиатурата показва само цифри и десетичен разделител, и не показва букви, дори ако потребителят превключи режим. Според Android Developers Documentation (2026), комбинирането на класове с флагове позволява създаването на високоспециализирани режими: многоредов текст с автоматична корекция, число с плаваща запетая, парола с възможност за автоматично довършване.

Важно е да се разбере, че Keyboard Type е препоръка към системата за въвеждане (IME). Някои клавиатури на трети страни (Gboard, SwiftKey) могат частично да игнорират зададения тип, ако потребителят е конфигурирал собствени предпочитания. Въпреки това, повечето стандартни Android клавиатури и Google Gboard стриктно следват зададения тип на въвеждане.

// Програмна настройка на типа клавиатура
editText.inputType = InputType.TYPE_CLASS_NUMBER or
    InputType.TYPE_NUMBER_FLAG_DECIMAL or
    InputType.TYPE_NUMBER_FLAG_SIGNED

Text — стандартна текстова клавиатура

TYPE_CLASS_TEXT — базовият клас за текстово въвеждане. Активира стандартната QWERTY клавиатура с букви, цифри и символи. Класът Text има най-голям брой модификатори, които уточняват поведението: TYPE_TEXT_FLAG_CAP_SENTENCES (автоматична главна буква в началото на изречение), TYPE_TEXT_FLAG_AUTO_CORRECT (автоматична корекция), TYPE_TEXT_FLAG_MULTI_LINE (многоредов режим), TYPE_TEXT_FLAG_NO_SUGGESTIONS (изключване на предложения).

Модификаторите на текстовата клавиатура могат да се комбинират, създавайки точна конфигурация: например, text|textCapSentences|textAutoCorrect е подходящ за поле за въвеждане на коментар, където са необходими автоматична главна буква и корекция на правописни грешки. Докато text|textNoSuggestions се използва за въвеждане на код или специални термини, където автоматичната корекция може да навреди.

Според данни от UX Stack Exchange (2025), текстовата клавиатура с включена автоматична корекция ускорява въвеждането с 15–25% за средния потребител, но за технически термини (код, URL, email) се препоръчва изключване на автоматичната корекция, тъй като тя често заменя правилните термини с грешни.

<!-- Text with autocorrect and capital sentences -->
android:inputType="textCapSentences|textAutoCorrect"

<!-- Text without suggestions and autocorrect -->
android:inputType="textNoSuggestions"

Number — цифрова клавиатура

TYPE_CLASS_NUMBER активира цифровата клавиатура, която показва само цифри, десетичен разделител и знак минус. Този тип се използва за полета за въвеждане на количество, цени, възраст, кодове и други цифрови данни. Цифровата клавиатура заема по-малко място на екрана от текстовата и изключва случайно въвеждане на букви.

Number има три модификатора: TYPE_NUMBER_FLAG_DECIMAL добавя десетична точка/запетая, TYPE_NUMBER_FLAG_SIGNED добавя знак минус за отрицателни числа, TYPE_NUMBER_VARIATION_PASSWORD — за PIN кодове, където цифрите се показват като скрити символи. Комбинацията number|numberDecimal|numberSigned създава пълноценно поле за въвеждане на числа с плаваща запетая с произволен знак.

• number — цели положителни числа (възраст, брой продукти).
• numberDecimal — числа с десетична част (цени, тегло, ръст).
• numberSigned — числа със знак (температура, координати).
• numberPassword — скрито въвеждане на цифри за PIN кодове.

// Цифрово въвеждане с десетична точка
editText.inputType = InputType.TYPE_CLASS_NUMBER or
    InputType.TYPE_NUMBER_FLAG_DECIMAL

// Проверете въведеното число
val amount = editText.text.toString().toDoubleOrNull() ?: 0.0

Phone и Email — специализирани клавиатури

TYPE_CLASS_PHONE активира телефонната клавиатура, която показва цифри и символи, характерни за телефонни номера: +, #, *, (, ). За разлика от number клавиатурата, phone също показва буквено оформление в допълнителен режим, тъй като телефонните номера могат да съдържат букви (например 1-800-FLOWERS). Класът phone няма допълнителни флагове, но поддържа TYPE_TEXT_VARIATION_PHONE_ETC за въвеждане на вътрешни номера.

TYPE_TEXT_VARIATION_EMAIL_ADDRESS активира email клавиатурата, на която символът @ и точката се намират на основния екран, а също така са налични чести домейн разширения (.com, .net, .org). Gboard допълнително показва бутони с популярни домейни при въвеждане след @. Email клавиатурата автоматично изключва автоматичната корекция, тъй като email адресите могат да съдържат нестандартни комбинации от символи.

Според Google Material Design Guidelines (2025), за телефонни полета се препоръчва допълнително да се посочи атрибутът android:digits, който ограничава набора от разрешени символи. За email полета също е важно да се посочи autofillHints="email" за поддръжка на автоматично довършване от мениджъра на пароли и Google Autofill.

<!-- Email keyboard with autofill -->
android:inputType="textEmailAddress"
android:importantForAutofill="yes"
android:autofillHints="emailAddress"

<!-- Phone keyboard with digit restriction -->
android:inputType="phone"
android:digits="0123456789+"

Password — клавиатура за пароли

TYPE_TEXT_VARIATION_PASSWORD и TYPE_NUMBER_VARIATION_PASSWORD — са режими за въвеждане на поверителни данни. При задаване на textPassword, въведените символи се показват като точки или звездички (в зависимост от версията на Android и клавиатурата). Клавиатурата в този режим изключва автоматичната корекция и запазването на въведени думи в речника на потребителя, предотвратявайки изтичане на парола чрез функции за предиктивно въвеждане.

Password клавиатурата също изключва възможността за правене на екранна снимка на съдържанието на полето (флаг FLAG_SECURE), въпреки че това поведение зависи от имплементацията на конкретната клавиатура. От Android 8.0 (API 26) нататък, password клавиатурите поддържат автоматично довършване чрез мениджъри на пароли, ако е зададен атрибутът importantForAutofill="yes".

Според Android Security Recommendations (2025), за полета за пароли също се препоръчва: задаване на maxLength за предотвратяване на много дълги пароли (които могат да бъдат атака върху базата данни), използване на inputType="textPassword" заедно с TextInputLayout и endIconMode="password_toggle", за да може потребителят да провери въведената парола преди изпращане на формуляра.

<!-- Password field with show/hide icon -->
@+id/tilPasswordField
app:endIconMode="password_toggle">

    @+id/etPasswordField
    android:inputType="textPassword"
    android:maxLength="64"
    android:importantForAutofill="yes" />

</com.google.android.material.textfield.TextInputLayout>

Настройка на Keyboard Type в код

Програмната настройка на Keyboard Type позволява динамична промяна на режима на клавиатурата в зависимост от контекста или потребителския вход. Например, при превключване на типа поле (текст/число/дата) или при промяна на локала. Методът setInputType() приема битова маска InputType и незабавно актуализира клавиатурата, ако полето е на фокус.

Динамично превключване на тип

// Превключване между текстово и цифрово въвеждане
fun switchInputType(field: EditText, isNumeric: Boolean) {
    field.inputType = if (isNumeric) {
        InputType.TYPE_CLASS_NUMBER or
            InputType.TYPE_NUMBER_FLAG_DECIMAL
    } else {
        InputType.TYPE_CLASS_TEXT or
            InputType.TYPE_TEXT_FLAG_CAP_SENTENCES
    }
    field.setSelection(field.text.length)
}

Проверка на текущия тип

// Проверете дали полето е цифрово
fun isNumericInput(field: EditText): Boolean {
    val type = field.inputType
    return (type and InputType.TYPE_MASK_CLASS) ==
        InputType.TYPE_CLASS_NUMBER
}

// Проверете дали автоматичната корекция е включена
fun isAutoCorrectEnabled(field: EditText): Boolean {
    return (field.inputType and
        InputType.TYPE_TEXT_FLAG_AUTO_CORRECT) != 0
}