View binding   Bagian dari Android Jetpack.

View binding adalah fitur yang memudahkan penulisan kode yang berinteraksi dengan tampilan. Setelah diaktifkan dalam sebuah modul, view binding akan menghasilkan class binding untuk setiap file tata letak XML yang ada dalam modul tersebut. Instance class binding berisi referensi langsung ke semua tampilan yang memiliki ID dalam tata letak yang sesuai.

Pada umumnya, view binding menggantikan findViewById.

Penyiapan

View binding diaktifkan di level modul. Untuk mengaktifkan view binding dalam modul, setel opsi build viewBinding ke true dalam file build.gradle level modul, seperti yang ditunjukkan dalam contoh berikut:

Groovy

android {
    ...
    buildFeatures {
        viewBinding true
    }
}

Kotlin

android {
    ...
    buildFeatures {
        viewBinding = true
    }
}

Jika Anda ingin mengabaikan file tata letak saat membuat class binding, tambahkan atribut tools:viewBindingIgnore="true" ke tampilan root file tata letak tersebut:

<LinearLayout
        ...
        tools:viewBindingIgnore="true" >
    ...
</LinearLayout>

Penggunaan

Jika view binding diaktifkan untuk sebuah modul, class binding akan dihasilkan untuk setiap file tata letak XML yang ada di dalam modul. Setiap class binding berisi referensi ke tampilan root dan semua tampilan yang memiliki ID. Nama class binding dibuat dengan mengonversi nama file XML menjadi Pascal case dan menambahkan kata "Binding" ke bagian akhirnya.

Misalnya, pertimbangkan file tata letak bernama result_profile.xml yang berisi hal berikut:

<LinearLayout ... >
    <TextView android:id="@+id/name" />
    <ImageView android:cropToPadding="true" />
    <Button android:id="@+id/button"
        android:background="@drawable/rounded_button" />
</LinearLayout>

Class binding yang dihasilkan disebut ResultProfileBinding. Class ini memiliki dua kolom: TextView yang disebut name dan Button yang disebut button. ImageView dalam tata letak tidak memiliki ID, sehingga tidak ada referensi ke sana dalam class binding.

Setiap class binding juga mencakup metode getRoot(), yang menyediakan referensi langsung untuk tampilan root file tata letak yang terkait. Dalam contoh ini, metode getRoot() di class ResultProfileBinding menampilkan tampilan root LinearLayout.

Bagian berikut menunjukkan penggunaan class binding yang dihasilkan dalam aktivitas dan fragmen.

Menggunakan view binding dalam aktivitas

Untuk menyiapkan instance class binding agar dapat digunakan dengan aktivitas, lakukan langkah-langkah berikut dalam metode onCreate() aktivitas:

1. Panggil metode inflate() statis yang disertakan dalam class binding yang dihasilkan. Tindakan ini membuat instance dari class binding yang akan digunakan aktivitas.
2. Dapatkan referensi ke tampilan root dengan memanggil metode getRoot() atau menggunakan sintaksis properti Kotlin.
3. Teruskan tampilan root ke setContentView() untuk menjadikannya sebagai tampilan aktif di layar.

Langkah-langkah ini ditampilkan dalam contoh berikut.

Kotlin

private lateinit var binding: ResultProfileBinding

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    binding = ResultProfileBinding.inflate(layoutInflater)
    val view = binding.root
    setContentView(view)
}

Java

private ResultProfileBinding binding;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    binding = ResultProfileBinding.inflate(getLayoutInflater());
    View view = binding.getRoot();
    setContentView(view);
}

Sekarang, Anda dapat menggunakan instance class binding untuk merujuk ke tampilan mana pun:

Kotlin

binding.name.text = viewModel.name
binding.button.setOnClickListener { viewModel.userClicked() }

Java

binding.name.setText(viewModel.getName());
binding.button.setOnClickListener(new View.OnClickListener() {
    viewModel.userClicked()
});

Menggunakan view binding di fragmen

Untuk menyiapkan instance class binding agar dapat digunakan dengan fragmen, lakukan langkah-langkah berikut dalam metode onCreateView() fragmen:

1. Panggil metode inflate() statis yang disertakan dalam class binding yang dihasilkan. Tindakan ini membuat instance class binding yang akan digunakan fragmen.
2. Dapatkan referensi ke tampilan root dengan memanggil metode getRoot() atau menggunakan sintaksis properti Kotlin.
3. Tampilkan tampilan root dari metode onCreateView() untuk menjadikannya sebagai tampilan aktif di layar.

Catatan: Metode inflate() mengharuskan Anda meneruskan inflater tata letak. Jika tata letak sudah di-inflate, Anda dapat memanggil metode bind() statis class binding.

Kotlin

private var _binding: ResultProfileBinding? = null
// This property is only valid between onCreateView and
// onDestroyView.
private val binding get() = _binding!!

override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?
): View? {
    _binding = ResultProfileBinding.inflate(inflater, container, false)
    val view = binding.root
    return view
}

override fun onDestroyView() {
    super.onDestroyView()
    _binding = null
}

Java

private ResultProfileBinding binding;

@Override
public View onCreateView (LayoutInflater inflater,
                          ViewGroup container,
                          Bundle savedInstanceState) {
    binding = ResultProfileBinding.inflate(inflater, container, false);
    View view = binding.getRoot();
    return view;
}

@Override
public void onDestroyView() {
    super.onDestroyView();
    binding = null;
}

Sekarang, Anda dapat menggunakan instance class binding untuk merujuk ke tampilan mana pun:

Kotlin

binding.name.text = viewModel.name
binding.button.setOnClickListener { viewModel.userClicked() }

Java

binding.name.setText(viewModel.getName());
binding.button.setOnClickListener(new View.OnClickListener() {
    viewModel.userClicked()
});

Catatan: Fragment aktif lebih lama dari tampilannya. Pastikan Anda membersihkan semua referensi untuk instance class binding dalam metode onDestroyView() fragmen.

Memberikan petunjuk untuk berbagai konfigurasi

Saat Anda mendeklarasikan tampilan di beberapa konfigurasi, terkadang akan lebih baik untuk menggunakan jenis tampilan yang berbeda, bergantung pada tata letak tertentu. Cuplikan kode berikut menunjukkan contohnya:

# in res/layout/example.xml

<TextView android:id="@+id/user_bio" />

# in res/layout-land/example.xml

<EditText android:id="@+id/user_bio" />

Dalam hal ini, Anda mungkin mengharapkan class yang dihasilkan mengekspos kolom userBio dari jenis TextView, karena TextView adalah class dasar umum. Karena keterbatasan teknis, generator kode view binding tidak dapat menentukannya dan sebagai gantinya menghasilkan kolom View. Tindakan ini memerlukan transmisi kolom nanti dengan binding.userBio as TextView.

Untuk mengatasi batasan ini, view binding mendukung atribut tools:viewBindingType, sehingga Anda dapat memberi tahu compiler jenis yang akan digunakan dalam kode yang dihasilkan. Pada contoh sebelumnya, Anda dapat menggunakan atribut ini untuk membuat compiler membuat kolom sebagai TextView:

# in res/layout/example.xml (unchanged)

<TextView android:id="@+id/user_bio" />

# in res/layout-land/example.xml

<EditText android:id="@+id/user_bio" tools:viewBindingType="TextView" />

Dalam contoh lain, misalkan Anda memiliki dua tata letak, satu tata letak berisi BottomNavigationView dan satu lagi berisi NavigationRailView. Kedua class memperluas NavigationBarView, yang berisi sebagian besar detail implementasi. Jika kode Anda tidak perlu mengetahui subclass mana yang ada di tata letak saat ini, Anda dapat menggunakan tools:viewBindingType untuk menetapkan jenis yang dihasilkan ke NavigationBarView di kedua tata letak:

# in res/layout/navigation_example.xml

<BottomNavigationView android:id="@+id/navigation" tools:viewBindingType="NavigationBarView" />

# in res/layout-w720/navigation_example.xml

<NavigationRailView android:id="@+id/navigation" tools:viewBindingType="NavigationBarView" />

View binding tidak dapat memvalidasi nilai atribut ini saat membuat kode. Untuk menghindari error waktu kompilasi dan runtime, nilai harus memenuhi kondisi berikut:

• Nilai harus berupa class yang mewarisi dari android.view.View.

• Nilainya harus berupa superclass tag tempatnya ditempatkan. Misalnya, nilai berikut tidak berfungsi:

    <TextView tools:viewBindingType="ImageView" /> <!-- ImageView is not related to TextView. -->
    <TextView tools:viewBindingType="Button" /> <!-- Button is not a superclass of TextView. -->
  

• Jenis akhir harus di-resolve secara konsisten di semua konfigurasi.

Perbedaannya dengan findViewById

View binding memiliki keunggulan penting dibandingkan findViewById:

• Keamanan null: karena view binding membuat referensi langsung ke tampilan, tidak ada risiko pengecualian pointer null karena ID tampilan yang tidak valid. Selain itu, jika tampilan hanya ada di beberapa konfigurasi tata letak, kolom yang berisi referensinya di class binding akan ditandai dengan @Nullable.
• Keamanan jenis: kolom di setiap class binding memiliki jenis yang cocok dengan tampilan yang direferensikannya dalam file XML. Artinya, tidak ada risiko pengecualian cast class.

Perbedaan ini berarti inkompatibilitas antara tata letak dan kode Anda akan menyebabkan build gagal pada waktu kompilasi, bukan pada waktu proses.

Perbandingannya dengan data binding

View binding dan data binding sama-sama menghasilkan class binding yang dapat Anda gunakan untuk mereferensikan tampilan secara langsung. Namun, view binding ditujukan untuk menangani kasus penggunaan yang lebih sederhana dan memberikan manfaat berikut dibandingkan data binding:

• Kompilasi yang lebih cepat: View binding tidak memerlukan pemrosesan anotasi, sehingga waktu kompilasi menjadi lebih cepat.
• Kemudahan penggunaan: View binding tidak memerlukan file tata letak XML yang diberi tag khusus, sehingga lebih mudah untuk diterapkan di aplikasi Anda. Setelah Anda mengaktifkan view binding dalam modul, view binding akan diterapkan ke semua tata letak modul tersebut secara otomatis.

Di sisi lain, view binding memiliki batasan berikut dibandingkan dengan data binding:

• View binding tidak mendukung variabel tata letak atau ekspresi tata letak, sehingga tidak dapat digunakan untuk mendeklarasikan konten UI dinamis langsung dari file tata letak XML.
• View binding tidak mendukung data binding dua arah.

Karena pertimbangan ini, dalam beberapa kasus, sebaiknya gunakan view binding dan data binding dalam sebuah project. Anda dapat menggunakan data binding dalam tata letak yang memerlukan fitur lanjutan dan menggunakan view binding dalam tata letak yang tidak memerlukan fitur lanjutan.

Referensi lainnya

Untuk mempelajari view binding lebih lanjut, lihat referensi tambahan berikut:

Blog

• Menggunakan view binding untuk mengganti findViewById

Video

• Android Jetpack: Mengganti findViewById dengan view binding