API Reference Item

FadeThroughNavigationTransitions

Provides fade through navigation transforms adhering to Material 3 motion specifications.

FadeThroughTransitionSample

@Preview
@Sampled
@Composable
fun FadeThroughTransitionSample() {
    var targetTab by remember { mutableIntStateOf(1) }
    var isGestureInProgress by remember { mutableStateOf(false) }
    var backEvent by remember { mutableStateOf(NavigationEvent()) }

    // TODO(b/561731740): Replace this manual navigation setup with NavDisplay once it adopts
    //  MutableContentTransform, which provides built-in transition and back gesture handling.
    val transitionState = remember { DeferredTransitionState(targetTab) }
    val transition = rememberDeferredTransition(transitionState)

    LaunchedEffect(isGestureInProgress, targetTab) {
        if (isGestureInProgress) {
            transitionState.defer(targetTab)
        } else {
            transitionState.animateTo(targetTab)
        }
    }

    val density = LocalDensity.current

    transition.DeferredAnimatedContent(
        transitionSpec = { FadeThroughNavigationTransitions.transform() },
        mutableTransformSpec = {
            FadeThroughNavigationTransitions.predictiveBackTransform(
                backEvent = { backEvent },
                density = density,
            )
        },
    ) { tab ->
        Surface(
            modifier = Modifier.fillMaxSize(),
            color =
                if (tab == 1) {
                    MaterialTheme.colorScheme.primaryContainer
                } else {
                    MaterialTheme.colorScheme.tertiaryContainer
                },
        ) {
            Box(Modifier.fillMaxSize().padding(16.dp), contentAlignment = Alignment.Center) {
                Text("Tab $tab", style = MaterialTheme.typography.headlineLarge)
            }
        }
    }
}
Jetpack Compose beyond MaterialFree components, screens and templates for apps that don’t look like Google’s. Copy them into your app, or let your coding agent add them.Browse for free

Content updated: