常用共享元素用例

在动画化共享元素时,一些特定的用例有一些具体的建议。

异步图像

通常使用库异步加载图像,例如使用Coil 的 AsyncImage 可组合函数。为了使其在两个可组合函数之间无缝工作,建议将 placeholderMemoryCacheKey()memoryCacheKey() 设置为与共享元素键派生的字符串相同的键,以便匹配的共享元素的缓存键相同。新的共享元素将使用其匹配项的缓存作为占位符,直到它加载新图像。

AsyncImage 的典型用法如下所示

AsyncImage(
    model = ImageRequest.Builder(LocalContext.current)
        .data("your-image-url")
        .crossfade(true)
        .placeholderMemoryCacheKey("image-key") //  same key as shared element key
        .memoryCacheKey("image-key") // same key as shared element key
        .build(),
    placeholder = null,
    contentDescription = null,
    modifier = Modifier
        .size(120.dp)
        .sharedBounds(
            rememberSharedContentState(
                key = "image-key"
            ),
            animatedVisibilityScope = this
        )
)

文本

要动画化 fontSize 更改,请使用 Modifier.sharedBounds()resizeMode = ScaleToBounds()。此过渡使尺寸变化相对流畅。可以调整 contentScale 参数以动画化特定的字体粗细或样式。

Text(
    text = "This is an example of how to share text",
    modifier = Modifier
        .wrapContentWidth()
        .sharedBounds(
            rememberSharedContentState(
                key = "shared Text"
            ),
            animatedVisibilityScope = this,
            enter = fadeIn(),
            exit = fadeOut(),
            resizeMode = SharedTransitionScope.ResizeMode.ScaleToBounds()
        )
)

TextAlign 更改默认情况下**不会**进行动画化。而是使用 Modifier.wrapContentSize() / Modifier.wrapContentWidth() 而不是为共享过渡使用不同的 TextAlign