このページは Cloud Translation API によって翻訳されました。

パララックススクロール効果を作成する

パララックススクロールは、背景コンテンツと前景コンテンツを異なる速度でスクロールする手法です。この手法を実装すると、アプリの UI を強化し、ユーザーがスクロールする際によりダイナミックなエクスペリエンスを実現できます。

バージョンの互換性

この実装では、プロジェクトの minSDK を API レベル 21 以上に設定する必要があります。

依存関係

パララックス効果を作成する

パララックス効果を実現するには、スクロールコンポーザブルのスクロール値の一部を、パララックス効果が必要なコンポーザブルに適用します。次のスニペットは、2 つのネストされたビジュアル要素（画像とテキストのブロック）を取り、同じ方向に異なる速度でスクロールします。

@Composable
fun ParallaxEffect() {
    fun Modifier.parallaxLayoutModifier(scrollState: ScrollState, rate: Int) =
        layout { measurable, constraints ->
            val placeable = measurable.measure(constraints)
            val height = if (rate > 0) scrollState.value / rate else scrollState.value
            layout(placeable.width, placeable.height) {
                placeable.place(0, height)
            }
        }

    val scrollState = rememberScrollState()
    Column(
        modifier = Modifier
            .fillMaxWidth()
            .verticalScroll(scrollState),
    ) {

        Image(
            painterResource(id = R.drawable.cupcake),
            contentDescription = "Android logo",
            contentScale = ContentScale.Fit,
            // Reduce scrolling rate by half.
            modifier = Modifier.parallaxLayoutModifier(scrollState, 2)
        )

        Text(
            text = stringResource(R.string.detail_placeholder),
            modifier = Modifier
                .background(Color.White)
                .padding(horizontal = 8.dp),

        )
    }
}ParallaxEffect.kt