RecyclerView

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

recyclerView.setHasFixedSize(true)

Используется в RecyclerView.Adapter для указания, что идентификаторы элементов списка стабильны и не изменяются при изменении данных. Этот метод помогает RecyclerView оптимизировать процесс отображения элементов. Если идентификаторы стабильны, RecyclerView может эффективно повторно использовать представления и избегать ненужных операций по созданию и привязке. Если у вас есть список объектов, где каждый объект имеет уникальный и неизменяемый идентификатор, вы можете включить стабильные идентификаторы.

class MyAdapter: RecyclerView.Adapter<MyViewHolder>() {
    
    init {
        setHasStableIds(true)
    }

    override fun getItemId(position: Int): Long {
        return dataList[position].id // Предполагается, что id - это уникальный идентификатор
    }

    // Остальные методы адаптера...
}

Используется для включения или отключения вложенной прокрутки для View, которая поддерживает вложенное прокручивание, например, RecyclerView или ScrollView. Метод позволяет управлять тем, будет ли View обрабатывать события прокрутки, происходящие из его дочерних элементов. Если у вас есть RecyclerView внутри ScrollView, вы можете отключить вложенную прокрутку для RecyclerView, чтобы предотвратить конфликты прокрутки.

recyclerView.setNestedScrollingEnabled(false)

Создаёт новый ViewHolder, который будет использован для отображения элемента списка.

override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MyViewHolder {
    val itemView = LayoutInflater.from(parent.context).inflate(R.layout.item_layout, parent, false)
    return MyViewHolder(itemView)
}

Вызывается для привязки данных к ViewHolder на указанной позиции. Здесь происходит обновление содержимого элемента списка в соответствии с данными.

override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
    val item = dataList[position]
    holder.bind(item)
}

Возвращает количество элементов в списке. Используется для определения размера данных, которые будут отображены.

override fun getItemCount(): Int {
    return dataList.size
}

Возвращает тип представления для элемента на данной позиции. Может использоваться для отображения разных типов элементов в одном списке.

override fun getItemViewType(position: Int): Int {
    return if (position % 2 == 0) TYPE_EVEN else TYPE_ODD
}

Вызывается, когда ViewHolder больше не используется и может быть переработан для повторного использования. Полезно для освобождения ресурсов.

override fun onViewRecycled(holder: MyViewHolder) {
    super.onViewRecycled(holder)
    // Освободить ресурсы
}

Вызывается, когда ViewHolder прикрепляется к окну, т.е. когда элемент становится видимым на экране.

override fun onViewAttachedToWindow(holder: MyViewHolder) {
    super.onViewAttachedToWindow(holder)
    // Действия при появлении View
}

Вызывается, когда ViewHolder открепляется от окна, т.е. когда элемент больше не виден.

override fun onViewDetachedFromWindow(holder: MyViewHolder) {
    super.onViewDetachedFromWindow(holder)
    // Действия при исчезновении View
}

Обновляет список данных. При вызове этого метода адаптер рассчитывает разницу между текущим и новым списком с помощью DiffUtil, чтобы применить минимальные изменения.

val newList = listOf(Item(1, "One"), Item(2, "Two"))
adapter.submitList(newList)

Возвращает элемент списка на указанной позиции.

val item = adapter.getItem(0) // Item(1, "One")

Возвращает текущий список элементов, который был установлен через submitList().

val currentList = adapter.currentList

Создаёт новый ViewHolder, который будет использован для отображения элемента списка.

override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MyViewHolder {
    val itemView = LayoutInflater.from(parent.context).inflate(R.layout.item_layout, parent, false)
    return MyViewHolder(itemView)
}

Связывает данные с ViewHolder.

override fun onBindViewHolder(holder: MyViewHolder, position: Int) {
    holder.bind(getItem(position))
}

Возвращает тип представления для элемента на определённой позиции.

override fun getItemViewType(position: Int): Int {
    return if (getItem(position).isSpecial) 1 else 0
}

Возвращает количество элементов в списке.

val count = adapter.itemCount

Добавляет новый адаптер в конец списка объединенных адаптеров.

concatAdapter.addAdapter(adapter3)

Удаляет указанный адаптер из списка объединенных адаптеров.

concatAdapter.removeAdapter(adapter2)

Вызывается, когда данные адаптера изменяются.

Вызывается, когда изменяются элементы в указанном диапазоне.

Вызывается, когда новые элементы добавляются в адаптер.

Вызывается, когда элементы удаляются из адаптера.

Вызывается, когда элементы перемещаются внутри адаптера.

Устанавливает направление прокрутки для LayoutManager. Если reverseLayout равно true, элементы будут отображаться в обратном порядке.

layoutManager.reverseLayout = true // Элементы будут отображаться в обратном порядке

Определяет ориентацию LayoutManager: вертикальную или горизонтальную.

linearLayoutManager.orientation = LinearLayoutManager.VERTICAL

gridLayoutManager.orientation = GridLayoutManager.HORIZONTAL

staggeredGridLayoutManager.orientation = StaggeredGridLayoutManager.VERTICAL

Перемещает RecyclerView к указанной позиции, чтобы сделать элемент видимым.

recyclerView.layoutManager?.scrollToPosition(5) // Прокрутка к элементу с позицией 5

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

recyclerView.layoutManager?.scrollToPositionWithOffset(5, 20) // Прокрутка к элементу с позицией 5, смещение на 20 пикселей

Используется для получения видимого представления (View) элемента на основе его позиции в RecyclerView. Этот метод позволяет напрямую получить представление элемента, которое уже отображается на экране.

val view = recyclerView.layoutManager?.findViewByPosition(position)

Проверяет, может ли RecyclerView прокручиваться вертикально. Возвращает true, если прокрутка возможна.

val canScrollVertically = recyclerView.layoutManager?.canScrollVertically() == true

Проверяет, может ли RecyclerView прокручиваться горизонтально. Возвращает true, если прокрутка возможна.

val canScrollHorizontally = recyclerView.layoutManager?.canScrollHorizontally() == true

Управляет расположением элементов в RecyclerView в виде линейного списка. Он позволяет организовать элементы вертикально или горизонтально.

val layoutManager = LinearLayoutManager(context)

recyclerView.layoutManager = layoutManager

setStackFromEnd

Устанавливает флаг, указывающий, следует ли располагать элементы от конца списка (например, для чатов).

layoutManager.stackFromEnd = true

findFirstVisibleItemPosition

Возвращает позицию первого видимого элемента в списке.

val firstVisiblePosition = layoutManager.findFirstVisibleItemPosition()

findLastVisibleItemPosition

Возвращает позицию последнего видимого элемента в списке.

val lastVisiblePosition = layoutManager.findLastVisibleItemPosition()

Управляет расположением элементов в RecyclerView в виде сетки. Он позволяет задавать количество столбцов и управлять пространством между элементами.

val layoutManager = GridLayoutManager(context, 2) // 2 столбца
        
recyclerView.layoutManager = layoutManager

setStackFromEnd

Устанавливает флаг, указывающий, следует ли располагать элементы от конца списка (например, для чатов).

layoutManager.stackFromEnd = true

setSpanCount

Устанавливает количество столбцов в сетке.

layoutManager.spanCount = 4

getSpanCount

Возвращает текущее количество столбцов.

val spanCount = layoutManager.spanCount

findFirstVisibleItemPosition

Возвращает позицию первого видимого элемента в списке.

val firstVisiblePosition = layoutManager.findFirstVisibleItemPosition()

findLastVisibleItemPosition

Возвращает позицию последнего видимого элемента в списке.

val lastVisiblePosition = layoutManager.findLastVisibleItemPosition()

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

val layoutManager = StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL) // 2 столбца

recyclerView.layoutManager = layoutManager

setSpanCount

Устанавливает количество столбцов в сетке.

layoutManager.spanCount = 4

getSpanCount

Возвращает текущее количество столбцов.

val spanCount = layoutManager.spanCount

setGapStrategy

Устанавливает стратегию обработки промежутков в StaggeredGridLayoutManager. Стратегия может влиять на то, как RecyclerView обрабатывает видимые и невидимые элементы при изменении размера.

• GAP_HANDLING_MOVE_ITEMS_BETWEEN_SPANS - позволяет автоматически перемещать элементы между спанами, чтобы заполнить пустые промежутки, которые могут возникнуть при добавлении или удалении элементов. Это помогает поддерживать более равномерное распределение элементов по всей области RecyclerView.

• GAP_HANDLING_REMOVE_ITEMS - устраняет промежутки между спанами, не перемещая другие элементы. При удалении элементов, пустые промежутки остаются, и другие элементы не будут изменять свои позиции.

layoutManager.gapStrategy = StaggeredGridLayoutManager.GAP_HANDLING_MOVE_ITEMS_BETWEEN_SPANS

getGapStrategy

Возвращает текущую стратегию обработки промежутков, установленную в StaggeredGridLayoutManager.

val gapStrategy = layoutManager.getGapStrategy()

findFirstVisibleItemPositions

Находит позиции первых видимых элементов и заполняет указанный массив.

val firstVisiblePositions = IntArray(2)
layoutManager.findFirstVisibleItemPositions(firstVisiblePositions)

findLastVisibleItemPositions

Находит позиции последних видимых элементов и заполняет указанный массив.

val lastVisiblePositions = IntArray(2)
layoutManager.findLastVisibleItemPositions(lastVisiblePositions)

Метод, который принимает экземпляр DiffUtil.Callback для сравнения старого и нового списков. Он возвращает DiffUtil.DiffResult, который можно использовать для обновления RecyclerView.

val diffResult = DiffUtil.calculateDiff(object: DiffUtil.Callback() { /* Implementation */ })

Применяет изменения к адаптеру на основе результатов, полученных от DiffUtil.

diffResult.dispatchUpdatesTo(myRecyclerViewAdapter)

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

val oldList = listOf("A", "B", "C")
val newList = listOf("A", "C", "D")

val diffResult = DiffUtil.calculateDiff(object: DiffUtil.Callback() {
    
    override fun getOldListSize(): Int = oldList.size
    
    override fun getNewListSize(): Int = newList.size

    override fun areItemsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean {
        return oldList[oldItemPosition] == newList[newItemPosition]
    }

    override fun areContentsTheSame(oldItemPosition: Int, newItemPosition: Int): Boolean {
        return oldList[oldItemPosition] == newList[newItemPosition]
    }
})

diffResult.dispatchUpdatesTo(myRecyclerViewAdapter)

Возвращает размер старого списка.

Возвращает размер нового списка.

Проверяет, ссылаются ли элементы на один и тот же объект (уникальность).

Проверяет, имеют ли элементы одинаковые данные (содержимое).

Вызывается для рисования фона или декораций позади элементов списка.

override fun onDraw(c: Canvas, parent: RecyclerView, state: RecyclerView.State) {
    // Пример добавления разделителей между элементами
    for (i in 0 until parent.childCount) {
        val child = parent.getChildAt(i)
        val params = child.layoutParams as RecyclerView.LayoutParams
        val top = child.bottom + params.bottomMargin
        val bottom = top + 2 // Толщина линии

        c.drawRect(child.left.toFloat(), top.toFloat(), child.right.toFloat(), bottom.toFloat(), Paint().apply {
            color = Color.GRAY
        })
    }
}

Вызывается для рисования поверх элементов списка, после того как они уже отрисованы.

override fun onDrawOver(c: Canvas, parent: RecyclerView, state: RecyclerView.State) {
    // Например, можно добавить полупрозрачную маску поверх элементов
    val paint = Paint().apply { color = Color.argb(50, 0, 0, 0) }
    c.drawRect(0f, 0f, parent.width.toFloat(), parent.height.toFloat(), paint)
}

Используется для установки отступов (padding или margin) вокруг элементов.

override fun getItemOffsets(outRect: Rect, view: View, parent: RecyclerView, state: RecyclerView.State) {
    // Пример добавления отступов между элементами
    outRect.set(16, 16, 16, 16)
}

RecycledViewPool позволяет настроить максимальное количество ViewHolder, которые могут быть сохранены в пуле для каждого типа представления.

recycledViewPool.setMaxRecycledViews(viewType, maxCount)

Связывает SnapHelper с указанным экземпляром RecyclerView.

snapHelper.attachToRecyclerView(recyclerView)

Определяет, какой элемент должен быть снэпнут (приближен к центру) в зависимости от текущего положения прокрутки и заданного LayoutManager.

val layoutManager = recyclerView.layoutManager as LinearLayoutManager
val snapView = snapHelper.findSnapView(layoutManager)

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

override fun findTargetSnapPosition(layoutManager: RecyclerView.LayoutManager, velocityX: Int, velocityY: Int): Int {
    // Возвращает целевую позицию на основе скорости прокрутки
    return super.findTargetSnapPosition(layoutManager, velocityX, velocityY)
}

Вычисляет расстояние, которое нужно прокрутить для достижения целевого элемента. Он возвращает массив, содержащий расстояние по оси X и Y.

val distance = pagerSnapHelper.calculateScrollDistance(dx, dy)
val scrollX = distance[0]
val scrollY = distance[1]

Вычисляет расстояние до окончательной позиции снэпа для указанного элемента. Возвращает массив из двух значений — расстояния по X и Y.

override fun calculateDistanceToFinalSnap(layoutManager: RecyclerView.LayoutManager, targetView: View): IntArray {
    val distance = super.calculateDistanceToFinalSnap(layoutManager, targetView)
    // Здесь можно использовать distance[0] и distance[1] для работы с расстоянием
    return distance
}

Обрабатывает события флинга. Этот метод вызывается, когда пользователь флинет список. Если он возвращает true, флинг будет обработан, если false, то нет.

override fun onFling(recyclerView: RecyclerView, velocityX: Int, velocityY: Int): Boolean {
    // Здесь можно добавить кастомное поведение при флинге
    return super.onFling(recyclerView, velocityX, velocityY)
}

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

val linearSnapHelper = LinearSnapHelper()
snapHelper.attachToRecyclerView(linearSnapHelper)

Предназначен для создания эффекта карусели в RecyclerView. Он позволяет элементам в списке «крутиться» по кругу, а также обеспечивает плавное и отзывчивое поведение при прокрутке и снэпинге.

val carouselSnapHelper = CarouselSnapHelper()
carouselSnapHelper.attachToRecyclerView(recyclerView)

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

val pagerSnapHelper = PagerSnapHelper()
pagerSnapHelper.attachToRecyclerView(recyclerView)