Dodawanie obsługi animacji przewidywanego przejścia wstecz w widokach

Za pomocą widoków lub Compose możesz tworzyć niestandardowe animacje i przejścia właściwości w aplikacji, niestandardowe animacje między aktywnościami i niestandardowe animacje między fragmentami z gestami przewidywanego przejścia wstecz. Aby wypróbować metodę Compose, zapoznaj się z artykułem Dodawanie obsługi animacji przewidywanego przejścia wstecz.

Dodawanie niestandardowych przejść za pomocą interfejsu Progress API

W AndroidX Activity w wersji 1.8.0-alpha01 lub nowszej możesz używać interfejsów Predictive Back Progress API do tworzenia niestandardowych animacji dla gestu przewidywanego przejścia wstecz w aplikacji. Interfejsy Progress API są przydatne do animowania widoków, ale mają ograniczenia, jeśli chodzi o animowanie przejść między fragmentami. W ramach OnBackPressedCallback wprowadziliśmy metody handleOnBackProgressed, handleOnBackCancelled i handleOnBackStarted, które umożliwiają animowanie obiektów, gdy użytkownik przesuwa palcem wstecz. Użyj tych metod, jeśli chcesz dostosować więcej niż domyślne animacje udostępniane przez system lub animacje komponentów Material Design.

Spodziewamy się, że większość aplikacji będzie używać zgodnych wstecznie interfejsów API AndroidX, ale w interfejsie OnBackAnimationCallback dostępne są też podobne interfejsy API platformy, które można przetestować w Androidzie 14 i nowszych wersjach.

Używanie interfejsów API postępu z przejściami AndroidX

Interfejsów API postępu można używać z AndroidX Transitions w wersji 1.5.0-alpha01 lub nowszej na Androidzie 14 lub nowszym, aby tworzyć przejścia z przewidywanym przejściem wstecz.

  1. Użyj TransitionManager#controlDelayedTransition zamiast beginDelayedTransition, aby odtwarzać przejścia, gdy użytkownik przesuwa palcem wstecz.
  2. Utwórz przejście w ciągu handleOnBackStarted.
  3. Odtwórz przejście ze zdarzeniem wstecz w ciągu handleOnBackProgressed, powiązując currentFraction z BackEvent.progress, co pokazuje, jak daleko użytkownik przesunął palcem wstecz.
  4. Zakończ przejście po wykonaniu przez użytkownika gestu wstecz w aplikacji handleOnBackPressed.
  5. Na koniec zresetuj stan przejścia w handleOnBackCancelled.

Poniższy film, kod Kotlin i kod XML pokazują niestandardowe przejście między 2 polami zaimplementowane za pomocą OnBackPressedCallback:

    class MyFragment : Fragment() {

    val transitionSet = TransitionSet().apply {
        addTransition(Fade(Fade.MODE_OUT))
        addTransition(ChangeBounds())
        addTransition(Fade(Fade.MODE_IN))
    }
    ...
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        val callback = object : OnBackPressedCallback(enabled = false) {

            var controller: TransitionSeekController? = null

            @RequiresApi(34)
            override fun handleOnBackStarted(backEvent: BackEvent) {
                // Create the transition
                controller = TransitionManager.controlDelayedTransition(
                    binding.card,
                    transitionSet
                )
                changeTextVisibility(ShowText.SHORT)
            }

            @RequiresApi(34)
            override fun handleOnBackProgressed(backEvent: BackEvent) {
                // Play the transition as the user swipes back
                if (controller?.isReady == true) {
                    controller?.currentFraction = backEvent.progress
                }
            }

            override fun handleOnBackPressed() {
                // Finish playing the transition when the user commits back
                controller?.animateToEnd()
                this.isEnabled = false
            }

            @RequiresApi(34)
            override fun handleOnBackCancelled() {
                // If the user cancels the back gesture, reset the state
                transition(ShowText.LONG)
            }
        }

        binding.shortText.setOnClickListener {
            transition(ShowText.LONG)
            callback.isEnabled = true
        }

        this.requireActivity().onBackPressedDispatcher.addCallback(callback)
    }

    private fun transition(showText: ShowText) {
        TransitionManager.beginDelayedTransition(
            binding.card,
            transitionSet
        )
        changeTextVisibility(showText)
    }

    enum class ShowText { SHORT, LONG }
    private fun changeTextVisibility(showText: ShowText) {
        when (showText) {
            ShowText.SHORT -> {
                binding.shortText.isVisible = true
                binding.longText.isVisible = false
            }
            ShowText.LONG -> {
                binding.shortText.isVisible = false
                binding.longText.isVisible = true
            }
        }
    }
}
  
<?xml version="1.0" encoding="utf-8"?>
...
    <androidx.constraintlayout.widget.ConstraintLayout
        android:id="@+id/card"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        ...>

        <TextView
            android:id="@+id/short_text"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            ... />

        <TextView
            android:id="@+id/long_text"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:visibility="gone"
            .../>

    </androidx.constraintlayout.widget.ConstraintLayout>

Podczas pracy z przejściami przewidywanego przejścia wstecz pamiętaj o tych kwestiach:

  • Użyj isSeekingSupported, aby sprawdzić, czy przejście obsługuje przewidywane przejście wstecz.
  • Zastąp isSeekingSupported, aby zwracać wartość „true” w przypadku niestandardowych przejść.
  • Utwórz po 1 kontrolerze na każdą animację.
  • Przejścia przewidywanego przejścia wstecz są obsługiwane w przypadku przejść AndroidX, ale nie w przypadku przejść platformy. Zrezygnuj z przejść platformy i używaj przejść Animator i AndroidX.
  • Przejścia z przewidywanym przejściem wstecz są obsługiwane na urządzeniach z Androidem 14 lub nowszym i nie są zgodne wstecznie.
  • Obsługiwane są też przejścia utworzone za pomocą scen XML. W handleOnBackStarted ustaw TransitionSeekController na wynik TransitionManager.createSeekController zamiast wyniku controlDelayedTransition.

Dodatkowe materiały