Transisi kustom memungkinkan Anda membuat animasi yang tidak tersedia dari class transisi bawaan mana pun. Misalnya, Anda dapat menentukan transisi kustom yang mengubah warna latar depan kolom teks dan input menjadi abu-abu untuk menunjukkan bahwa kolom tersebut dinonaktifkan di layar baru. Jenis perubahan ini membantu pengguna melihat kolom yang Anda nonaktifkan.
Transisi kustom, seperti salah satu jenis transisi bawaan, menerapkan animasi ke tampilan turunan dari scene awal dan akhir. Namun, tidak seperti jenis transisi bawaan, Anda harus menyediakan kode yang mengambil nilai properti dan menghasilkan animasi. Anda mungkin juga ingin menentukan subset tampilan target untuk animasi Anda.
Halaman ini menunjukkan cara mengambil nilai properti dan membuat animasi untuk membuat transisi kustom.
Memperluas class Transisi
Untuk membuat transisi kustom, tambahkan class ke project Anda yang memperluas class Transition
dan ganti fungsi yang ditampilkan dalam cuplikan berikut:
Kotlin
class CustomTransition : Transition() { override fun captureStartValues(transitionValues: TransitionValues) {} override fun captureEndValues(transitionValues: TransitionValues) {} override fun createAnimator( sceneRoot: ViewGroup, startValues: TransitionValues?, endValues: TransitionValues? ): Animator? {} }
Java
public class CustomTransition extends Transition { @Override public void captureStartValues(TransitionValues values) {} @Override public void captureEndValues(TransitionValues values) {} @Override public Animator createAnimator(ViewGroup sceneRoot, TransitionValues startValues, TransitionValues endValues) {} }
Bagian berikut menjelaskan cara mengganti fungsi ini.
Mengambil nilai properti tampilan
Animasi transisi menggunakan sistem animasi properti yang dijelaskan dalam Ringkasan animasi properti. Animasi properti mengubah properti tampilan dari nilai awal ke nilai akhir selama jangka waktu yang ditentukan, sehingga framework harus memiliki nilai awal dan akhir properti untuk membuat animasi.
Namun, animasi properti biasanya hanya memerlukan subset kecil dari semua nilai properti tampilan. Misalnya, animasi warna memerlukan nilai properti warna, sedangkan animasi gerakan memerlukan nilai properti posisi. Karena nilai properti yang diperlukan untuk animasi bersifat khusus untuk transisi, framework transisi tidak memberikan setiap nilai properti ke transisi. Sebagai gantinya, framework memanggil fungsi callback yang memungkinkan transisi untuk hanya mengambil nilai properti yang diperlukan dan menyimpannya dalam framework.
Mengambil nilai awal
Untuk meneruskan nilai tampilan awal ke framework, implementasikan
fungsi
captureStartValues(transitionValues)
. Framework akan memanggil fungsi ini untuk setiap tampilan dalam scene awal. Argumen
fungsi adalah objek TransitionValues
yang berisi referensi
ke tampilan dan instance Map
tempat Anda dapat menyimpan nilai tampilan
yang Anda inginkan. Dalam implementasi Anda, ambil nilai properti ini dan teruskan kembali ke
framework dengan menyimpannya di peta.
Untuk memastikan kunci nilai properti tidak bertentangan dengan kunci
TransitionValues
lainnya, gunakan skema penamaan berikut:
package_name:transition_name:property_name
Cuplikan berikut menunjukkan implementasi fungsi captureStartValues()
:
Kotlin
class CustomTransition : Transition() { // Define a key for storing a property value in // TransitionValues.values with the syntax // package_name:transition_class:property_name to avoid collisions private val PROPNAME_BACKGROUND = "com.example.android.customtransition:CustomTransition:background" override fun captureStartValues(transitionValues: TransitionValues) { // Call the convenience method captureValues captureValues(transitionValues) } // For the view in transitionValues.view, get the values you // want and put them in transitionValues.values private fun captureValues(transitionValues: TransitionValues) { // Get a reference to the view val view = transitionValues.view // Store its background property in the values map transitionValues.values[PROPNAME_BACKGROUND] = view.background } ... }
Java
public class CustomTransition extends Transition { // Define a key for storing a property value in // TransitionValues.values with the syntax // package_name:transition_class:property_name to avoid collisions private static final String PROPNAME_BACKGROUND = "com.example.android.customtransition:CustomTransition:background"; @Override public void captureStartValues(TransitionValues transitionValues) { // Call the convenience method captureValues captureValues(transitionValues); } // For the view in transitionValues.view, get the values you // want and put them in transitionValues.values private void captureValues(TransitionValues transitionValues) { // Get a reference to the view View view = transitionValues.view; // Store its background property in the values map transitionValues.values.put(PROPNAME_BACKGROUND, view.getBackground()); } ... }
Mengambil nilai akhir
Framework ini memanggil fungsi captureEndValues(TransitionValues)
satu kali untuk setiap tampilan target pada scene akhir. Selain itu, captureEndValues()
berfungsi sama seperti captureStartValues()
.
Cuplikan kode berikut menunjukkan implementasi fungsi captureEndValues()
:
Kotlin
override fun captureEndValues(transitionValues: TransitionValues) { captureValues(transitionValues) }
Java
@Override public void captureEndValues(TransitionValues transitionValues) { captureValues(transitionValues); }
Dalam contoh ini, fungsi captureStartValues()
dan captureEndValues()
memanggil captureValues()
untuk mengambil dan menyimpan nilai. Properti tampilan
yang diambil captureValues()
sama, tetapi memiliki nilai yang berbeda dalam
scene awal dan akhir. Framework ini mempertahankan peta yang terpisah untuk status
awal dan akhir tampilan.
Membuat animator kustom
Untuk menganimasikan perubahan tampilan antara status pada scene awal dan scene akhir, sediakan animator dengan fungsi createAnimator()
. Saat framework memanggil fungsi ini, fungsi tersebut akan meneruskan tampilan root scene dan objek TransitionValues
yang berisi nilai awal dan akhir yang Anda ambil.
Frekuensi framework memanggil fungsi createAnimator()
bergantung pada
perubahan yang terjadi antara scene awal dan akhir.
Misalnya, pertimbangkan animasi fade-out atau
fade-in yang diimplementasikan sebagai transisi kustom. Jika scene awal memiliki lima target, dua di antaranya dihapus dari scene akhir, dan scene akhir memiliki tiga target dari scene awal ditambah target baru, framework akan memanggil createAnimator()
enam kali.
Tiga panggilan tersebut menganimasikan fade-out dan fade-in target yang tetap berada di kedua objek
adegan. Dua panggilan lainnya akan menganimasikan fade-out target yang dihapus dari scene akhir. Satu
panggilan menganimasikan fade-in target baru pada scene akhir.
Untuk tampilan target yang ada di scene awal dan akhir, framework menyediakan
objek TransitionValues
untuk argumen startValues
dan
endValues
. Untuk tampilan target yang hanya ada di scene awal atau
akhir, framework menyediakan objek TransitionValues
untuk argumen yang sesuai dan null
untuk argumen lainnya.
Untuk mengimplementasikan fungsi createAnimator(ViewGroup, TransitionValues, TransitionValues)
saat Anda membuat
transisi kustom, gunakan nilai properti tampilan yang Anda ambil untuk membuat objek Animator
dan tampilkan ke framework. Untuk contoh implementasi,
lihat class ChangeColor
dalam contoh
CustomTransition. Untuk informasi selengkapnya tentang animator properti, lihat Animasi properti.
Menerapkan transisi kustom
Transisi kustom sama fungsinya seperti transisi bawaan. Anda dapat menerapkan transisi kustom menggunakan pengelola transisi, seperti yang dijelaskan dalam Menerapkan transisi.