ListView – виджет для показа списка элементов. Можно использовать во всех приложениях, где используются списки. Для показа информации посредством ListView необходим класс производный от класса адаптера, в данном примере используется класс производный от BaseAdapter.
Создайте проект с использованием макета Empty Activity. Нажмите правой кнопкой мыши на папку res/layout и выберите New -> Layout Resource File. Назовите файл adapter_item.xml и укажите в качестве Root Element значение LinearLayout, затем в файле adapter_item.xml напишите следующий код:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:orientation="vertical"
android:padding="16dp">
<TextView
android:id="@+id/text"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:drawableLeft="@mipmap/ic_launcher"
android:drawablePadding="12dp"
android:gravity="center_vertical"
android:text="Sample"
android:textColor="@color/colorPrimary"
android:textSize="18sp" />
</LinearLayout>
В файле activity_main.xml напишите:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity"
android:orientation="vertical">
<ListView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:id="@+id/list"/>
</LinearLayout>
Добавьте новый класс (в предыдущих уроках было сказано как). Назовите класс SampleListAdapter в поле Superclass напишите BaseAdapter и в коде класса напишите:
// Класс предоставляющий возможность определения поведения адаптера для правильной привязки информации к виджетам
public class SampleListAdapter extends BaseAdapter {
// Объявление необходимых перенных получаемых через конструктор.
// Объект Context необходим для получения ссылки на Activity в котором адаптер подключается к ListView.
Context context;
// Массив для хранения элементов для привязки к ListView
List<String> items = new ArrayList<>();
// Конструктор класса адаптера, принимает параметры контекста и элементов переданных с Activity
public SampleListAdapter(Context context, List<String> items)
{
// Присвоить полученные параметры локальным переменным класса
this.context = context;
this.items = items;
}
// Функция для возвращения количества элементов
@Override
public int getCount() {
return items.size();
}
// Получить элемент для показа в необходимой позиции
@Override
public String getItem(int position) {
return items.get(position);
}
// Получить id элемента, обычно возвращается запрашиваемое значение переданное по параметру, потому что в массиве расположение элементов идёт по порядку и так и показывается в ListView на данный момент.
@Override
public long getItemId(int position) {
return position;
}
// Получить корневой View, в котором и распологаются виджеты
@Override
public View getView(int position, View view, ViewGroup parent) {
// Если View ещё не создавался создать
// иначе использовать уже созданный ранее view
if(view == null)
{
// Получить ссылку к экземпляру LayoutInflater для получения xml файла макета
LayoutInflater inflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
// Запросить файл макета и присвоить переменной view класса View теперь view это LinearLayout объявленный в файле adapter_item.xml
// В файле adapter_item.xml определяется макет для одной строки списка, потому что структура всех строк списка одинаковая
view = inflater.inflate(R.layout.adapter_item, parent, false);
}
// Найти ссылку на TextView внутри LinearLayout файла макета
TextView text = view.findViewById(R.id.text);
// Установить значение для TextView равной значению элемента массива соответствующей позиции данной строки
text.setText(items.get(position));
// Установить в качестве тега TextView значение позиции элемента тег может хранить в себе объект и служит для дальнейшего определения этого объекта по тегу или хранения и обработки информации, которую нет нужды показывать в интерфейсе пользователю
text.setTag(position);
// Вернуть объект View - корневой LinearLayout из файла adapter_item.xml
return view;
}
}
В файле MainActivity.java напишите этот код:
public class MainActivity extends AppCompatActivity {
// Виджет для показа списка
ListView listView;
// Массив для хранения заголовков
List<String> items = new ArrayList<>(Arrays.asList("Тоҷикистон", "Ӯзбекистон", "Қирғизистон", "Қазоқистон"));
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// Получение экземпляра ListView размещенного в макете
listView = findViewById(R.id.list);
// Объявление и инициализация экземпляра адаптера класса SimpleListAdapter адаптер служит для соединения данных с виджетом для показа
SampleListAdapter adapter = new SampleListAdapter(this, items);
// привязать адаптер к ListView
listView.setAdapter(adapter);
// Указать обработчик кликов по элементам списка
listView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
// Каждый раз при клике на какой-либо элемент вызывается функция onItemClick и ей передаётся в качестве параметра корневой элемент макета, в данном случае LinearLayout позиция выбранного элемента и id элемента. Через корневой элемент макета переданного через экземпляр класса View можно получить ссылку к любому объекту в макете. Например, через их id.
@Override
public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
// Получить ссылку на TextView в файле макета по id
TextView textView = view.findViewById(R.id.text);
// Показать сообщение с текстом TextView из файла макета
Toast.makeText(MainActivity.this, textView.getText(), Toast.LENGTH_SHORT).show();
}
});
}
}