此页面由 Cloud Translation API 翻译。

创建视差滚动效果

视差滚动是一种让背景内容和前景内容以不同速度滚动的技术。您可以通过实现此技术来增强应用的界面，在用户滚动时打造更具动态感的体验。

版本兼容性

此实现要求将项目 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