Jetpack Compose: BringIntoViewRequester

Jetpack Compose’in sunduğu harika özelliklerden biri olan BringIntoViewRequester’ı inceleyelim. Bu özellik, ekranda gözükmeyen bir liste item’ına veya normal bir view’e odaklamak ve görünür hale getirmek istediğimizde işimize çok yarıyor.

Bir örnek vermek gerekirse, varsayalım ki bir uygulamada kullanıcı bir listenin içinde kaydırıyor ve bir öğeyi görmek istiyor ama o öğe ekranda gözükmüyor. İşte tam burada BringIntoViewRequester devreye giriyor. Bu araç sayesinde ekranda görünmeyen bir öğeyi odaklayabilir ve kullanıcının istediği öğeyi görmesini sağlayabiliriz.

Ve benim buna odaklanmamı sağlayan en önemli etkişleşim şu oldu; bir item-view ekranda genişlediğinde, genişlediği alan kadar scroll ederek o öğeyi odaklamak mümkün. Böylece kullanıcılar, büyüyen öğelerin tamamını rahatlıkla görebilir ve uygulamayı daha iyi bir şekilde kullanabilirsiniz. Normalde expand olan item ekranın altında kalıyordu ve açılan kısım gözükmüyordu. Umarım işinize yarar :)

@file:OptIn(ExperimentalFoundationApi::class)

package com.erdegor.sample

import androidx.compose.animation.AnimatedContent
import androidx.compose.animation.SizeTransform
import androidx.compose.animation.fadeIn
import androidx.compose.animation.fadeOut
import androidx.compose.animation.togetherWith
import androidx.compose.foundation.ExperimentalFoundationApi
import androidx.compose.foundation.background
import androidx.compose.foundation.border
import androidx.compose.foundation.clickable
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.relocation.BringIntoViewRequester
import androidx.compose.foundation.relocation.bringIntoViewRequester
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.verticalScroll
import androidx.compose.material.Icon
import androidx.compose.material.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.MutableState
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.res.painterResource
import androidx.compose.ui.tooling.preview.Preview
import androidx.compose.ui.unit.dp
import kotlinx.coroutines.delay
import kotlinx.coroutines.launch

@Preview
@Composable
fun BringIntoViewRequesterContent() {

    val scope = rememberCoroutineScope()
    val scrollState = rememberScrollState()

    Column(
        verticalArrangement = Arrangement.spacedBy(12.dp),
        modifier = Modifier
            .fillMaxSize()
            .background(Color.White)
            .padding(horizontal = 12.dp)
            .verticalScroll(scrollState)
    ) {

        List(57) { "$it. item" }.forEach {

            val bringIntoViewRequesterItem = BringIntoViewRequesterItem(
                title = it,
                bringIntoViewRequester = mutableStateOf(BringIntoViewRequester())
            )

            BringIntoViewRequesterContentItem(
                item = bringIntoViewRequesterItem,
                onClick = {
                    scope.launch {
                        delay(200)
                        bringIntoViewRequesterItem.bringIntoViewRequester.value.bringIntoView()
                    }
                }
            )
        }

    }
}

@Composable
fun BringIntoViewRequesterContentItem(item: BringIntoViewRequesterItem, onClick: () -> Unit) {

    val isExpanded = remember {
        mutableStateOf(false)
    }

    Column(
        modifier = Modifier
            .bringIntoViewRequester(item.bringIntoViewRequester.value)
            .fillMaxWidth()
            .border(1.dp, color = Color.LightGray)
            .clickable {
                isExpanded.value = isExpanded.value.not()
                onClick.invoke()
            }
    ) {
        Row(
            modifier = Modifier
                .fillMaxWidth()
                .padding(8.dp),
            horizontalArrangement = Arrangement.SpaceBetween,
            verticalAlignment = Alignment.CenterVertically
        ) {
            Text(text = item.title)

            if (isExpanded.value) {
                Icon(
                    painter = painterResource(id = android.R.drawable.arrow_up_float),
                    contentDescription = "collapse"
                )
            } else {
                Icon(
                    painter = painterResource(id = android.R.drawable.arrow_down_float),
                    contentDescription = "expand"
                )
            }
        }

        AnimatedContent(
            modifier = Modifier.padding(16.dp),
            targetState = isExpanded,
            label = null,
            transitionSpec = {
                (fadeIn() togetherWith fadeOut()).using(SizeTransform(clip = false))
            }
        ) { targetState ->
            if (targetState.value) {
                Column {
                    List(5) { "$it. subItem" }.forEach {
                        Text(text = it)
                    }
                }
            }
        }
    }
}

data class BringIntoViewRequesterItem(
    val title: String,
    val bringIntoViewRequester: MutableState<BringIntoViewRequester>
)