Настройка динамического списка . Часть Android Jetpack .

Попробуйте способ создания
Jetpack Compose — рекомендуемый набор инструментов пользовательского интерфейса для Android. Узнайте, как работать с макетами в Compose.
Ленивые списки и сетки →

Вы можете настроить объекты RecyclerView в соответствии с вашими конкретными потребностями. Стандартные классы, описанные в разделе Создание динамических списков с помощью RecyclerView, предоставляют все функциональные возможности, необходимые большинству разработчиков. Во многих случаях вам нужно только спроектировать представление для каждого держателя представления и написать код для обновления этих представлений соответствующими данными. Однако если у вашего приложения есть особые требования, вы можете изменить стандартное поведение несколькими способами. В этом документе описаны некоторые возможные настройки.

Изменить макет

RecyclerView использует менеджер макетов для размещения отдельных элементов на экране и определения того, когда повторно использовать представления элементов, которые больше не видны пользователю. Чтобы повторно использовать (или переработать ) представление, менеджер макета может попросить адаптер заменить содержимое представления другим элементом из набора данных. Переработка представлений таким образом повышает производительность, позволяя избежать создания ненужных представлений или выполнения дорогостоящих поисков findViewById() . Библиотека поддержки Android включает три стандартных менеджера макетов, каждый из которых предлагает множество вариантов настройки:

  • LinearLayoutManager : упорядочивает элементы в одномерный список. Использование RecyclerView с LinearLayoutManager обеспечивает такие функции, как макет ListView .
  • GridLayoutManager : упорядочивает элементы в двумерной сетке, как квадраты на шахматной доске. Использование RecyclerView с GridLayoutManager предоставляет такие функции, как макет GridView .
  • StaggeredGridLayoutManager : упорядочивает элементы в двумерной сетке, где каждый столбец слегка смещен относительно предыдущего, как звезды на американском флаге.

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

Добавить анимацию предметов

Всякий раз, когда элемент изменяется, RecyclerView использует аниматор для изменения его внешнего вида. Этот аниматор является объектом, расширяющим абстрактный класс RecyclerView.ItemAnimator . По умолчанию RecyclerView использует DefaultItemAnimator для предоставления анимации. Если вы хотите предоставить собственные анимации, вы можете определить свой собственный объект аниматора, расширив RecyclerView.ItemAnimator .

Включить выбор элементов списка

Библиотека recyclerview-selection позволяет пользователям выбирать элементы в списке RecyclerView с помощью сенсорного ввода или мыши. Это позволяет вам сохранять контроль над визуальным представлением выбранного элемента. Вы также можете сохранить контроль над политиками, управляющими поведением выбора, например, какие элементы могут быть выбраны и сколько элементов можно выбрать.

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

  1. Определите, какой тип ключа выбора использовать, затем создайте ItemKeyProvider .

    Для идентификации выбранных элементов можно использовать три типа ключей:

    Подробные сведения о типах клавиш выбора см. в разделе SelectionTracker.Builder .

  2. Внедрите ItemDetailsLookup .

    3. ItemDetailsLookup позволяет библиотеке выбора получать доступ к информации об элементах RecyclerView заданных MotionEvent . По сути, это фабрика для экземпляров ItemDetails , резервная копия которых создается или извлекается из экземпляра RecyclerView.ViewHolder .

  3. Обновите объекты View элемента в RecyclerView чтобы отразить, выбирает ли пользователь их или отменяет их выбор.

    Библиотека выбора не предоставляет визуальное оформление по умолчанию для выбранных элементов. Укажите это при реализации onBindViewHolder() . Мы рекомендуем следующий подход:

    • В onBindViewHolder() вызовите setActivated() — а не setSelected() — для объекта View с true или false , в зависимости от того, выбран ли элемент.
    • Обновите стиль представления, чтобы отобразить активированный статус. Мы рекомендуем использовать ресурс списка состояний цвета для настройки стиля.
  4. Используйте ActionMode , чтобы предоставить пользователю инструменты для выполнения действия над выделенным фрагментом.

    5. Зарегистрируйте SelectionTracker.SelectionObserver , чтобы получать уведомления при изменении выбора. При первом создании выбора запустите ActionMode , чтобы представить его пользователю и выполнить действия, специфичные для выбора. Например, вы можете добавить кнопку удаления на панель ActionMode и соединить стрелку назад на панели, чтобы очистить выбор. Когда выбор становится пустым (если пользователь очищает выбор в последний раз), завершите режим действия.

  5. Выполните любые интерпретированные второстепенные действия.

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

  6. Соберите все с помощью SelectionTracker.Builder .

    7. В следующем примере показано, как соединить эти части:

    Котлин 

        var tracker = SelectionTracker.Builder(
        "my-selection-id",
        recyclerView,
        StableIdKeyProvider(recyclerView),
        MyDetailsLookup(recyclerView),
        StorageStrategy.createLongStorage())
            .withOnItemActivatedListener(myItemActivatedListener)
            .build()

    Ява

        SelectionTracker tracker = new SelectionTracker.Builder<>(
            "my-selection-id",
            recyclerView,
            new StableIdKeyProvider(recyclerView),
            new MyDetailsLookup(recyclerView),
            StorageStrategy.createLongStorage())
            .withOnItemActivatedListener(myItemActivatedListener)
            .build();

    Чтобы создать экземпляр SelectionTracker , ваше приложение должно предоставить тот же RecyclerView.Adapter , который вы используете для инициализации RecyclerView для SelectionTracker.Builder . По этой причине после создания экземпляра SelectionTracker внедрите его в свой RecyclerView.Adapter . В противном случае вы не сможете проверить выбранный статус элемента с помощью метода onBindViewHolder() .

  7. Включите выбор в события жизненного цикла действия .

    8. Чтобы сохранить состояние выбора в событиях жизненного цикла действия, ваше приложение должно вызывать методы onSaveInstanceState() и onRestoreInstanceState() средства отслеживания выбора из методов действия onSaveInstanceState() и onRestoreInstanceState() соответственно. Ваше приложение также должно предоставить уникальный идентификатор выбора конструктору SelectionTracker.Builder . Этот идентификатор необходим, поскольку действие или фрагмент могут иметь более одного отдельного выбираемого списка, каждый из которых должен сохраняться в сохраненном состоянии.

Дополнительные ресурсы

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