本頁面由 Cloud Translation API 翻譯而成。

建立視差捲動效果

視差捲動是一種技術，可讓背景內容和前景內容以不同速度捲動。您可以實作這項技巧來改善應用程式的 UI，為使用者提供更生動的捲動體驗。

版本相容性

這個實作方式需要將專案 minSDK 設為 API 級別 21 以上。

依附元件

建立視差效果

如要實現視差效果，請將捲動可組合項的捲動值的一小部分套用至需要視差效果的可組合項。以下程式碼片段會擷取兩個巢狀視覺元素 (圖片和文字區塊)，並以不同速度在同方向捲動：

@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