Освой Android играючи

Сайт Александра Климова

Шкодим

/* Моя кошка замечательно разбирается в программировании. Стоит мне объяснить проблему ей - и все становится ясно. */
John Robbins, Debugging Applications, Microsoft Press, 2000

EditText

EditText
Текст-подсказка
Вызов нужной клавиатуры
Интерфейс InputType
Атрибут android:imeOptions - параметры для текущего метода ввода
Заблокировать текстовое поле
Другие свойства
Методы
Выделение текста
Обработка нажатий клавиш
Пустой ли EditText
Превращаем EditText в TextView

Компонент EditText — это текстовое поле для пользовательского ввода, которое используется, если необходимо редактирование текста. Следует заметить, что EditText является наследником TextView.

В Android Studio на панели инструментов текстовые поля можно найти в категории Texts под разными именами.

EditText

Для быстрой разработки текстовые поля снабдили различными свойствами и дали разные имена: Plain Text, Person Name, Password, Password (Numeric), E-mail, Phone, Postal Address, Multiline Text, Time, Date, Number, Number (Signed), NumberDecimal.

Plain Text

Plain Text - самый простой вариант текстового поля без наворотов. При добавлении в разметку его XML-представление будет следующим:


<EditText
    android:id="@+id/editText1"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:ems="10" />

Person Name

При использовании элемента Person Name в XML добавляется атрибут inputType, который отвечает за вид клавиатуры (только буквы) при вводе текста.


<EditText
    android:id="@+id/editText2"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:ems="10"
    android:inputType="textPersonName" />

Password и Password (Numeric)

При использовании Password в inputType используется значение textPassword. При вводе текста сначала показывается символ, который заменяется на звёздочку. Если используется элемент Password (Numeric), то у атрибута inputType используется значение numberPassword. В этом случае на клавиатуре будут только цифры вместо букв. Вот и вся разница.


<EditText
    android:id="@+id/editText2"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:ems="10"
    android:inputType="textPassword" />

E-mail

У элемента E-mail используется атрибут android:inputType="textEmailAddress". В этом случае на клавиатуре появляется дополнительная клавиша с символом @, который обязательно используется в любом электронном адресе.

Кстати, финны называют символ @ кошачьим хвостом (взято из Википедии). А в России этот символ называют собакой. Где справедливость?

Phone

У элемента Phone используется атрибут android:inputType="phone". Клавиатура похожа на клавиатуру из старого кнопочного сотового телефона с цифрами, а также с кнопками звёздочки и решётки.

Postal Address

Атрибут android:inputType="textPostalAddress".

Multiline Text

У Multiline Text используется атрибут android:inputType="textMultiLine" позволяющий сделать текстовое поле многострочным. Дополнительно можете установить свойство Lines (атрибут android:lines), чтобы указать количество видимых строк на экране.


<EditText
    android:id="@+id/editText1"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:inputType="textMultiLine"
    android:lines="5" >

Time и Date

Атрибут android:inputType="time" или android:inputType="date". На клавиатуре цифры, точка, запятая, тире.

Number, Number (Signed), Number (Decimal)

Атрибут android:inputType="number" или numberSigned или numberDecimal. На клавиатуре только цифры и некоторые другие символы.

Текст-подсказка

Веб-мастера знают о таком атрибуте HTML5 как placeholder, когда в текстовом поле выводится строчка-подсказка приглушенным (обычно серым цветом). Живой пример приведён ниже.

Подсказка видна, если текстовый элемент не содержит пользовательского текста. Как только пользователь начинает вводить текст, то подсказка исчезает. Соответственно, если удалить пользовательский текст, то подсказка появляется снова. Это очень удобное решение во многих случаях, когда на экране мало места для элементов.

В Android у многих элементов есть свойство Hint (атрибут hint), который работает аналогичным образом. Установите у данного свойства нужный текст и у вас появится текстовое поле с подсказкой.

Подсказка

Запускаем приложение и видим подсказку, которая исчезает при попытке ввести текст.

Вызов нужной клавиатуры

Не во всех случаях нужна стандартная клавиатура с буковками и цифрами. Если вы пишете калькулятор, то проще показать пользователю цифровую клавиатуру. А если нужно ввести электронный адрес, то удобнее показать клавиатуру, где уже есть символ @. Ну а если ваше приложение пишется для котов, то достаточно вывести только те буквы, из которых можно составить слова Мяу и Жрать давай (к сожалению, такой клавиатуры ещё нет, но Google работает в этом направлении).

У элемента EditText на этот случай есть атрибут inputType:


<EditText android:id="@+id/etWidth1"
    android:hint="@string/catname"
    android:inputType="textCapWords"
    android:layout_height="wrap_content"
    android:layout_width="wrap_content">
</EditText>

В данном случае с атрибутом inputType="textCapWords" каждый первый символ каждого слова при вводе текста автоматически будет преобразовываться в прописную. Удобно, не так ли?

Значение textCapSentences делает прописным каждый первый символ предложения.

Если вам нужен режим CapsLock, то используйте значение textCapCharacters и все буквы сразу будут большими при наборе.

Для набора телефонного номера используйте phone, и тогда вам будут доступны только цифры, звёздочка (*), решётка (#).

Для ввода веб-адресов удобно использовать значение textUri. В этом случае у вас появится дополнительная кнопочка .com (при долгом нажатии на нее появятся альтернативные варианты .net, .org и др.).

Вот вам целый список доступных значений (иногда различия очень трудно различимы)

text
textCapCharacters (клавиатура с символами в верхнем регистре)
textCapWords
textCapSentences
textAutoCorrect
textAutoComplete
textMultiLine
textImeMultiLine
textNoSuggestions (без подсказок при вводе текста)
textUri
textEmailAddress
textEmailSubject
textShortMessage
textLongMessage
textPersonName
textPostalAddress
textPassword
textVisiblePassword (без автокоррекции)
textWebEditText
textFilter
textPhonetic
number
numberSigned
numberDecimal
phone
datetime
date
time

Интерфейс InputType

Кроме использования атрибута android:inputType мы можем добиться нужного поведения от текста при помощи интерфейса InputType.


// Делаем заглавным первый символ предложения
val inputType = InputType.TYPE_CLASS_TEXT or
        InputType.TYPE_TEXT_FLAG_CAP_SENTENCES
editText.inputType = inputType

// Другие варианты

// Только числа, десятичную точку и минус
val inputType = InputType.TYPE_CLASS_NUMBER or // allow numbers
        InputType.TYPE_NUMBER_FLAG_DECIMAL or // allow decimal numbers
        InputType.TYPE_NUMBER_FLAG_SIGNED // allow positive and negative numbers

Атрибут android:imeOptions - параметры для текущего метода ввода

У текстовых полей есть атрибут android:imeOptions, с помощью которого настраиваются параметры для текущего метода ввода. Например, когда EditText получает фокус и отображается виртуальная клавиатура, эта клавиатура содержит кнопку "Next" (Далее), если атрибут android:imeOptions содержит значение actionNext. Если пользователь касается этой кнопки, фокус перемещается к следующему компоненту, который принимает пользовательский ввод. Если компонент EditText получает фокус и на виртуальной клавиатуре появляется кнопка "Done" (Готово), значит использовался атрибут android:imeOptions со значением actionDone. Как только пользователь касается этой кнопки, система скрывает виртуальную клавиатуру.

Заблокировать текстовое поле

Для блокировки текстового поля присвойте значения false свойствам Focusable, Long clickable и Cursor visible.

Другие свойства

minLines и maxLines
Позволяют ограничить количество строк текста, которое можно ввести в текстовом поле
maxLength
Позволяет задать максимальное количество символов для ввода

Методы

Основной метод класса EditTextgetText(), который возвращает текст, содержащийся в текстовом поле. Возвращаемое значение имеет специальный тип Editable, а не String.


String strCatName = nickNameEditText.getText().toString(); // приводим к типу String

Соответственно, для установки текста используется метод setText().

В Kotlin может возникнуть проблема, если программист захочет использовать конструкцию присвоения через свойство.


editText.text = someText // нельзя!
edittext.setText(someText)

Большинство методов для работы с текстом унаследованы от базового класса TextView: setTypeface(null, Typeface), setTextSize(int textSize), SetTextColor(int Color).

Выделение текста

У EditText есть специальные методы для выделения текста:

  • selectAll() — выделяет весь текст;
  • setSelection(int start, int stop) — выделяет участок текста с позиции start до позиции stop;
  • setSelection(int index) — перемещает курсор на позицию index;

Предположим, нам нужно выделить популярное слово из трёх букв в большом слове (это слово "кот", а вы что подумали?).


// выделяем 4, 5, 6 символы
editText.setSelection(3, 6);

Выделение текста

Ещё есть метод setSelectAllOnFocus(), который позволяет выделить весь текст при получении фокуса.


editText.setSelectAllOnFocus(true)

Обработка нажатий клавиш

Для обработки нажатий клавиш необходимо зарегистрировать обработчик View.OnKeyListener, используя метод setOnKeyListener() элемента EditText. Например, для прослушивания события нажатия клавиши Enter во время ввода текста пользователем (или котом), используйте следующий код:


// Kotlin
// edit text enter key listener
editText.setOnKeyListener(object : View.OnKeyListener {
    override fun onKey(v: View?, keyCode: Int, event: KeyEvent): Boolean {
        // if the event is a key down event on the enter button
        if (event.action == KeyEvent.ACTION_DOWN &&
            keyCode == KeyEvent.KEYCODE_ENTER
        ) {
            // perform action on key press
            textView.text = "Pressed Enter Key\n\n${editText.text}"


            // clear focus and hide cursor from edit text
            editText.clearFocus()
            editText.isCursorVisible = false

            return true
        }
        return false
    }
})

// Java final EditText editText = findViewById(R.id.EditText1); editText.setOnKeyListener(new View.OnKeyListener() { public boolean onKey(View v, int keyCode, KeyEvent event) { if(event.getAction() == KeyEvent.ACTION_DOWN && (keyCode == KeyEvent.KEYCODE_ENTER)) { // сохраняем текст, введённый до нажатия Enter в переменную String strCatName = editText.getText().toString(); return true; } return false; } } );

Пустой ли EditText

Чтобы проверить, пустой ли EditText, можно воспользоваться кодом:


if (editText.getText().toString().equals(""))
{
// Здесь код, если EditText пуст
}
else
{
// если есть текст, то здесь другой код
}

Также можно проверять длину текста, если она равно 0, значит текст пуст.


if (editText.getText().length() == 0)

В Kotlin есть удобная функция-расширение ifEmpty(), позволяющая сделать проверку и задать значение по умолчанию, что очень удобно во многих случаях.


// если текстовое поле пустое, то задать текст по умолчанию
val cat = catEditText.text.ifEmpty { "Барсик" }.toString()

Превращаем EditText в TextView

Практического смысла тут нет, но для общего развития превратим текстовое поле в текстовую метку. Для этого нужно сделать компонент недоступным, убрать курсор, установить прозрачный фон и отключить слушатель нажатий клавиш.


EditText editText = (EditText)findViewById(R.id.editText);
editText.setEnabled(false);
editText.setCursorVisible(false);
editText.setBackgroundColor(Color.TRANSPARENT);
editText.setKeyListener(null);

Также можно установить эти свойства через XML, кроме последнего пункта.


<EditText
    android:id="@+id/editText"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@android:color/transparent"
    android:cursorVisible="false"
    android:editable="false"
    android:ems="10"
    android:text="Text" />

Дополнительное чтение

Переопределяем кнопку Enter

Собственный компонент - быстрая очистка текста

Beware EditText on API 21 - разница между версиями 21 и 22

Продвинутые примеры для текстовых полей (2-й курс/закрытая зона)

hani-momanii/SuperNova-Emoji: library to implement and render emojis For Android - библиотека, позволяющая печатать эмодзи-символы.

Реклама