此页面由 Cloud Translation API 翻译。

自定义共享元素过渡

如需自定义共享元素转换动画的运行方式，您可以使用以下几个参数来更改共享元素的转换方式。

动画规范

如需更改用于大小和位置移动的动画规范，您可以在 Modifier.sharedElement() 上指定不同的 boundsTransform 参数。这提供了初始 Rect 位置和目标 Rect 位置。

例如，如需让上例中的文本以弧形动作移动，请指定 boundsTransform 参数以使用 keyframes 规范：

val textBoundsTransform = BoundsTransform { initialBounds, targetBounds ->
    keyframes {
        durationMillis = boundsAnimationDurationMillis
        initialBounds at 0 using ArcMode.ArcBelow using FastOutSlowInEasing
        targetBounds at boundsAnimationDurationMillis
    }
}
Text(
    "Cupcake", fontSize = 28.sp,
    modifier = Modifier.sharedBounds(
        rememberSharedContentState(key = "title"),
        animatedVisibilityScope = animatedVisibilityScope,
        boundsTransform = textBoundsTransform
    )
)CustomizeSharedElementsSnippets.kt

您可以使用任何 AnimationSpec。此示例使用了 keyframes 规范。

图 1.显示不同 boundsTransform 参数的示例

调整大小模式

在两个共享边界之间进行动画处理时，您可以将 resizeMode 参数设置为 RemeasureToBounds 或 ScaleToBounds。此参数确定共享元素如何在两种状态之间转换。ScaleToBounds 首先使用预测（或目标）约束条件测量子布局。然后，系统会缩放子项的稳定布局，使其适合共享边界。ScaleToBounds 可以视为各种状态之间的“图形比例”。

而 RemeasureToBounds 会根据目标大小，使用带动画的固定约束条件重新测量和重新布局 sharedBounds 的子布局。重新测量由边界大小变化触发，可能每帧都会发生。

对于 Text 可组合项，建议使用 ScaleToBounds，因为它可以避免将文本重新布局并重新流动到不同的行。对于宽高比不同的边界，如果您希望两个共享元素之间保持流畅的连续性，建议使用 RemeasureToBounds。

以下示例展示了这两种大小调整模式之间的区别：

`ScaleToBounds`	`RemeasureToBounds`

跳至最终布局

默认情况下，在两个布局之间进行转换时，布局大小会在其开始状态和最终状态之间添加动画效果。在为文本等内容添加动画时，这可能是一种不必要的行为。

以下示例展示了说明文本“Lorem Ipsum”以两种不同的方式进入屏幕。在第一个示例中，文本在进入容器时会随着容器大小的增大而重新流布局；在第二个示例中，文本在增大时不会重新流布局。添加 Modifier.skipToLookaheadSize() 可防止自动重排。

不使用 Modifier.skipToLookahead() - 请注意“Lorem Ipsum”文本会重新流动	Modifier.skipToLookahead() - 请注意，“Lorem Ipsum”文本在动画开始时保持其最终状态

剪辑和叠加层

在 Compose 中创建共享元素时，有一个重要的概念：为了在不同的可组合项之间共享这些元素，当开始将可组合项转换为目标中的匹配项时，系统会将可组合项的渲染提升到层叠加层。这样做的效果是，它会逃出父级的边界及其图层转换（例如 alpha 和缩放）。

它将在其他非共享界面元素之上呈现，转换完成后，该元素将从叠加层移至自己的 DrawScope。

如需将共享元素剪裁为形状，请使用标准的 Modifier.clip() 函数。将其放在 sharedElement() 后面：

Image(
    painter = painterResource(id = R.drawable.cupcake),
    contentDescription = "Cupcake",
    modifier = Modifier
        .size(100.dp)
        .sharedElement(
            rememberSharedContentState(key = "image"),
            animatedVisibilityScope = this@AnimatedContent
        )
        .clip(RoundedCornerShape(16.dp)),
    contentScale = ContentScale.Crop
)CustomizeSharedElementsSnippets.kt

如果您需要确保共享元素绝不会在父容器之外呈现，可以对 sharedElement() 设置 clipInOverlayDuringTransition。默认情况下，对于嵌套的共享边界，clipInOverlayDuringTransition 会使用父 sharedBounds() 中的剪裁路径。

如需支持在共享元素过渡期间始终将特定界面元素（例如底部栏或悬浮操作按钮）保持在顶部，请使用 Modifier.renderInSharedTransitionScopeOverlay()。默认情况下，当共享过渡处于活动状态时，此修饰符会将内容保留在叠加层中。

例如，在 Jetsnack 中，需要将 BottomAppBar 放置在共享元素上，直到屏幕不可见。将修饰符添加到可组合项后，该可组合项会保持 elevated 状态。

不含 `Modifier.renderInSharedTransitionScopeOverlay()`	使用 `Modifier.renderInSharedTransitionScopeOverlay()`

有时，您可能希望非共享可组合项在转换前以动画效果消失，同时保持在其他可组合项之上。在这种情况下，请使用 renderInSharedTransitionScopeOverlay().animateEnterExit() 在共享元素过渡运行时为可组合项添加动画效果：

JetsnackBottomBar(
    modifier = Modifier
        .renderInSharedTransitionScopeOverlay(
            zIndexInOverlay = 1f,
        )
        .animateEnterExit(
            enter = fadeIn() + slideInVertically {
                it
            },
            exit = fadeOut() + slideOutVertically {
                it
            }
        )
)CustomizeSharedElementsSnippets.kt

图 2. 在动画过渡时滑入和滑出底部应用栏

在极少数情况下，如果您不希望共享元素在叠加层中呈现，可以将 sharedElement() 上的 renderInOverlayDuringTransition 设置为 false。

通知同级布局共享元素大小的更改

默认情况下，sharedBounds() 和 sharedElement() 不会在布局转换时通知父级容器任何大小更改。

如需在父级容器转换时将尺寸更改传播到父级容器，请将 placeHolderSize 参数更改为 PlaceHolderSize.animatedSize。这样做会导致内容增大或缩小。布局中的所有其他项都会响应此更改。

PlaceholderSize.contentSize（默认）

PlaceholderSize.animatedSize

（请注意，列表中的其他项如何随着某个项的增大而向下移动）

简介

常见使用场景