Autocompletetextview android что это

AutoCompieteTextview и MultiAutoCompleteTextView

AutoCompleteTextView

Компонент AutoCompleteTextView — это текстовое поле с автозаполнением и возможностью редактирования вводимого текста. Использование компонента удобно в том случае, когда требуется ускорить процесс ввода текста.

На панели инструментов элемент можно найти в разделе Texts.

AutoCompleteTextView является подклассом EditText, поэтому доступны все возможности форматирования и редактирования текста родительского класса.

Дополнительно, у AutoCompleteTextView есть свойство completionThreshold для указания минимального числа символов, которое должен ввести пользователь, чтобы включилась функция автозаполнения. Для связывания с данными необходимо задействовать адаптер, содержащий список значений через метод setAdapter().

Для упрощения создадим статический массив строк с именами котов и свяжем его через адаптер с нашим элементом в Java-коде. В реальных приложениях лучше использовать строковые ресурсы.

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

Пример с строковыми ресурсами (res/values/string.xml).

Получаем массив из ресурсов и используем в адаптере.

Пример для Kotlin

Напишем аналогичный пример на Kotlin и добавим несколько новых слушателей.

Стилизация

Подготовим тему в styles.xml:

Подключим тему к компоненту.

Место вывода выпадающего списка

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

Добавим кнопку под текстовым полем и будем выводить выпадающий список под кнопкой.

Динамический подбор

В примере используется готовый набор слов для подстановки. Можно модифицировать программу, чтобы список слов был динамическим. Когда пользователь напечатает новое слово и нажмёт ОК, то проверяем наличие данного слова в массиве. Если такого слова нет, то добавляем в массив. Для решения данной задачи обычный строковый массив нам не подойдёт, будем использовать List .

Собственный адаптер для выпадающего списка подсказок

Можно настроить свой адаптер для вывода подсказок, используя интерфейсы Filterable и ListAdapter. Можно наследоваться от ArrayAdapter, который уже имеет эти интерфейсы.

Попробуйте реализовать пример самостоятельно и пришлите его мне.

MultiAutoCompleteTextView

На панели инструментов компонент можно найти в том же разделе Texts.

Использование компонента удобно в том случае, когда требуется ускорить процесс ввода текста.

MultiAutoCompleteTextView — это текстовое поле с автозаполнением и возможностью редактирования вводимого текста, расширяющее функциональность AutoCompieteTextview, который может показывать автозаполнение для каждой из подстрок текста, разделенных знаком пунктуации. Разделитель задается явно вызовом метода setTokenizer().

MultiAutoCompleteTextView является подклассом EditText и AutoCompleteTextView, поэтому доступны все возможности форматирования и редактирования текста родительских классов, описанных выше.

Пример практически не будет отличаться от предыдущего. Главная особенность — можно задать строковый массив в виде строк, разделенных запятой, например, так:

Теперь, при наборе первых букв, будет выводиться не одно слово, а сразу пара слов.

Библиотеки

EmailAutoCompleteTextView — данные берутся из списка контактов вашего телефона

Источник

Android AutoCompleteTextView с подсказками из веб-сервиса

Для одного из своих Android-приложений Book Tracker я реализовал кастомный AutoCompleteTextView с подсказками для названий книг, которые динамически подгружаются с Google Books по мере ввода названия книги.

Задача перед компонентом стояла следующая:

• Загрузка данных должна осуществляться в отдельном потоке, чтобы не блокировать UI-поток;
• Загрузка подсказок должна начинаться только, если пользователь приостанавливает набор (чтобы предотвратить отправку множества запросов к серверу после каждого введенного символа);
• Подсказки должны загружаться, если пользователь ввел строку некоторой минимальной длины (нет смысла начинать загрузку данных для строки из двух или трех символов);
• При запросе к серверу в правой части поля должен быть показан анимированный прогресс, чтобы информировать пользователя о загрузке.

Финальный результат:

Шаг 1 – реализация кастомного адаптера для AutoCompleteTextView

Адаптер для AutoCompleteTextView – это ключевой компонент, в котором происходит загрузка и хранение подсказок. BookAutoCompleteAdapter реализовывает интерфейс Filterable, чтобы перехватывать ввод пользователя из AutoCompleteTextView и передавать его в качестве поискового запроса в веб-сервис. Единственный метод интерфейса Filterable – это getFilter(), который должен возвращать экземпляр класса Filter, осуществляющий загрузку и публикацию данных. Наследники класса Filter должны реализовать два метода: performFiltering(CharSequence constraint) и publishResults(CharSequence constraint, Filter.FilterResults results).

Метод performFiltering будет вызван в отдельном потоке автоматически, поэтому нет необходимости создавать и запускать новый поток вручную. Это уже сделано за разработчика в классе Filter. Метод publishResults же вызывается в UI-потоке, чтобы опубликовать результаты на экране.

BookAutoCompleteAdapter.java

Шаг 2 – создание XML-разметки для строки подсказки

Когда подсказки загружены, будет показан выпадающий список с результатами. Каждая строка состоит из двух элементов: названия книги и имени автора.

simple_dropdown_item_2line.xml

Шаг 3 – добавление задержки перед отправкой запроса на сервер

При использовании стандартного AutoCompleteTextView запрос инициируется после каждого введенного символа. Если пользователь набирает текст без остановки, подсказки, полученные для предыдущего запроса, могут оказаться неактуальными при вводе каждого последующего символа. Это порождает ненужные и ресурсоемкие обращения к серверу, появляется шанс превышения лимитов API, которые может иметь веб-сервис, а также возвращаются устаревшие результаты, загруженные для предыдущего состояния строки запроса.

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

Чтобы реализовать вышеописанное поведение, нужно создать кастомную реализацию AutoCompleteTextView и переопределить метод performFiltering(CharSequence text, int keyCode). Поле mAutoCompleteDelay определяет время в миллисекундах, после которого запрос будет отправлен на сервер, если пользователь не ввел новых символов.

DelayAutoCompleteTextView.java

Шаг 4 – добавление анимированного прогресса к полю ввода

Очень важно обеспечить обратную связь, когда пользователь набирает текст. Необходимо показать анимированный прогресс в поле ввода названия книги. Прогресс нужен для того, чтобы проинформировать человека о том, что подсказки загружаются и будут скоро отображены. Таким образом пользователь будет осведомлен и сможет подождать пока они не появятся. Без такой обратной связи человек может даже не подозревать о том, что поле может показывать подсказки.

Элементы ProgressBar и DelayAutoCompleteTextView необходимо поместить во FrameLayout и выровнять ProgressBar по правой стороне родительской группы. Также необходимо изначально скрыть прогресс с помощью установки атрибута android:visibility=«gone».

ProgressBar подключается к DelayAutoCompleteTextView с помощью метода setLoadingIndicator(ProgressBar view) последнего. Видимость элемента прогресса устанавливается в View.VISIBLE, когда происходит загрузка подсказок и в View.GONE, когда загрузка завершена.

Шаг 5 – соединение компонентов

Теперь, когда все части готовы, необходимо соединить их вместе:

bookTitle.setThreshold(4) определяет минимальное количество символов, которые должен ввести пользователь, чтобы были показаны подсказки.

bookTitle.setLoadingIndicator((ProgressBar) findViewById(R.id.progress_bar)) соединяет ProgressBar с DelayAutoCompleteTextView.

Важно установить OnItemClickListener для DelayAutoCompleteTextView и присвоить правильное значение полю ввода. Если этого не сделать, результат вызова метода toString() выбранного объекта будет вставлен в поле вместо названия книги.

Источник

Пример использования AutoCompleteTextView в Android

В этой статье мы научимся получать подсказки с помощью компонента AutoCompleteTextView . Как обычно, рассмотрим все на простом примере.

Виджет AutoCompleteTextView в Android. Теория

Виджет AutoCompleteTextView показывает подсказки во время ввода текста пользователем. Список этих подсказок отображается в виде раскрывающегося меню, из которого пользователь может выбрать подходящую подсказку. Набор всех возможных подсказок предоставляется адаптером и появляется только после того, как пользователь введет несколько символов.

В XML макете виджет определяется следующим образом:

Обратите внимание на атрибут a ndroid:ems . Он устанавливает ширину виджета TextView , независимо от фактического размер вводимого текста.

Наиболее полезные методы при работе с виджетом AutoCompleteTextView в коде:

• Метод setAdapter() устанавливает адаптер в виджет AutoCompleteTextView .
• Метод getAdapter() возвращает адаптер, используемый для автоматического предоставления подсказок
• Метод getCompletionHint() возвращает текст, отображаемый в нижней части списка подсказок.
• Метод getDropDownAnchor() возвращает возвращает идентификатор View, к которому отностится выпадающий список.
• Метод getListSelection() возвращает позицию элемента из выпадающего списка.
• Метод isPopupShowing() определяет, показано всплывающее меню или нет
• Метод setText(CharSequence text, boolean filter) устанавливает текст в виджет с позможностью отключить фильтрацию
• Метод showDropDown() показывает выпадающий список

Виджет AutoCompleteTextView в Android. Пример

В нашем примере мы используем виджет TextView и AutoCompleteTextView в компоновке RelativeLayout. В коде мы будем использовать ArrayAdapter со списком каких-либо элементов. Для простоты примера мы будем использовать захардкоденные данные в массиве. В реальном же приложении эти данные будут предоставлены из базы данных или от какого-либо интернет-сервиса.

Источник

Android AutoCompleteTextView Example Tutorial

In this android AutoCompleteTextView, example tutorial you will learn what is autocompletetextview.We will see how to implement it in android studio with examples.

Android AutoCompleteTextView

Android AutoCompleteTextView is a TextView that can be editable which is similar to EditText.What makes it different is it displays a drop down with list of suggestions based on user input.The user can choose an item from the list or continue to type manually.

Check this android UI controls tutorial to know more about UI controls

Creating AutoCompleteTextView in Android

Creating AutoCompleteTextView in android can be done in two ways.One is to define it in XML(layout)file.The other way is creating an object of it in Java programatically.

Creating AutoCompleteTextView in XML(layout)

Creating AutoCompleteTextView in JAVA(Programatically)

To display the suggestions for AutoCompleteTextView, we need to set the value for threshold attribute.Threshold value is nothing but the number of charecters after which the suggestions should appear.
Eg : Threshold = 2 makes the AutoCompleteTextView display a list of suggestions only after the user types 2 charecters.

The list of suggestions for AutoCompleteTextView will be populated form data adapter.
Generally AutoCompleteTextView is used to display text values so we will use ArrayAdapter for populating the suggestions list.

Android ArrayAdapter

In android ArraAdapter is used to display single type of data backed by an array like list of names, list of numbers, books etc.

Code snippet for array adapter in JAVA

Getting value from AutoCompleteTextView

Android AutoCompleteTextview Attributes

Since AutoCompleteTextView is subclass of EditText we can inherit all the properties of EditText to AutocompleteTextview.So all the attributes of EditText will work for AutoCompleteTextView.

Refer Android EditText Attributes section of this Android EditText example Tutorial.

Item Click Listener & Item SelectedListener

Whenever the user clicks an item from the dropdown list it triggers a click event and the OnItemClickListener() method on AutoCompleteTextView object listens the click event and executes the code inside onItemClick() method.

In case of an AutoCompleteTextView the OnItemSelectedListener() is similar to OnItemClickListener() since clicking and selecting almost does the same thing which is getting data of that selected item.

Code snippet for ItemClickListener

Code snippet for ItemSelectedListener

Android AutocompleteTextView Example

Lets see an example of implementing AutocompleteTextview where we bind a list of courses to AutoCompleteTextView and displaing the course name that was clicked by the user in a Toast message.

First we have to declare AutoCompletetextView in XML so lets do it.
Creating AutoCompleteTextView in XML

Now that we have declared AutocompleteTextView in XML we have to use that in java to set data.

We have to create an array of data which we want to display as suggestions.

Declaring an array of data in Activity(JAVA)

Now we have to create an arrayAdapter and bind the string array to arrayAdapter.

Now set the adapter to AutoCompleteTextView object and set threshold

Implementing clickListener on AutoCompleteTextView object and displaying a toast message when the user clicks on any item from the suggestions.

The final XML file will look like this

The final Activity(JAVA) file will look like this

Источник