Bağlama bağdaştırıcıları, değerleri ayarlamak için uygun çerçeve çağrılarını yapmaktan sorumludur. Örneğin, setText() yöntemini çağırarak bir özellik değeri ayarlayabilirsiniz. Başka bir örnek de setOnClickListener() yöntemini çağırmak gibi bir etkinlik işleyici ayarlamaktır.
Veri Bağlama Kitaplığı, bir değer ayarlamak için çağrılan yöntemi belirtmenize, kendi bağlama mantığınızı sağlamanıza ve bağdaştırıcıları kullanarak döndürülen nesnenin türünü belirtmenize olanak tanır.
Özellik değerlerini ayarlama
Bağlı bir değer her değiştiğinde, oluşturulan bağlama sınıfı, bağlama ifadesiyle görünümde bir ayarlayıcı yöntemi çağırmalıdır. Veri Bağlama Kitaplığı'nın yöntemi otomatik olarak belirlemesine izin verebilir veya yöntemi açıkça beyan edebilir ya da bir yöntem seçmek için özel mantık sağlayabilirsiniz.
Otomatik yöntem seçimi
example adlı bir özellik için kitaplık, bağımsız değişken olarak uyumlu türleri kabul eden setExample(arg) yöntemini otomatik olarak bulur. Özelliğin ad alanı dikkate alınmaz. Yöntem aranırken yalnızca özellik adı ve türü kullanılır.
Örneğin, android:text="@{user.name}" ifadesi verildiğinde kitaplık, user.getName() tarafından döndürülen türü kabul eden bir setText(arg) yöntemi arar. user.getName() yönteminin dönüş türü String ise kitaplık, String bağımsız değişkenini kabul eden bir setText() yöntemi arar. İfade bir int döndürürse kitaplık, int bağımsız değişkenini kabul eden bir setText() yöntemi arar. İfade, doğru türü döndürmelidir. Gerekirse dönüş değerini dönüştürebilirsiniz.
Veri bağlama, belirtilen ada sahip bir özellik olmasa bile çalışır. Veri bağlamayı kullanarak herhangi bir ayarlayıcı için özellik oluşturabilirsiniz. Örneğin, destek sınıfı DrawerLayout'in özellikleri yoktur ancak çok sayıda ayarlayıcısı vardır. Aşağıdaki düzen, app:scrimColor ve app:drawerListener özelliklerinin ayarlayıcısı olarak sırasıyla setScrimColor(int) ve addDrawerListener(DrawerListener) yöntemlerini otomatik olarak kullanır:
<androidx.drawerlayout.widget.DrawerLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
app:scrimColor="@{@color/scrim}"
app:drawerListener="@{fragment.drawerListener}">
Özel bir yöntem adı belirtin
Bazı özelliklerin adla eşleşmeyen ayarlayıcıları vardır. Bu gibi durumlarda, BindingMethods ek açıklaması kullanılarak bir özellik, ayarlayıcıyla ilişkilendirilebilir. Ek açıklama bir sınıfla birlikte kullanılır ve her biri yeniden adlandırılmış bir yöntem için olmak üzere birden fazla BindingMethod ek açıklaması içerebilir. Bağlama yöntemleri, uygulamanızdaki herhangi bir sınıfa ekleyebileceğiniz ek açıklamalardır.
Aşağıdaki örnekte, android:tint özelliği setTint() yöntemiyle değil, setImageTintList(ColorStateList) yöntemiyle ilişkilendirilmiştir:
Kotlin
@BindingMethods(value = [ BindingMethod( type = android.widget.ImageView::class, attribute = "android:tint", method = "setImageTintList")])
Java
@BindingMethods({ @BindingMethod(type = "android.widget.ImageView", attribute = "android:tint", method = "setImageTintList"), })
Genellikle Android çerçeve sınıflarındaki ayarlayıcıları yeniden adlandırmanız gerekmez. Özellikler, eşleşen yöntemleri otomatik olarak bulmak için adlandırma kuralı kullanılarak zaten uygulanmıştır.
Özel mantık sağlama
Bazı özellikler için özel bağlama mantığı gerekir. Örneğin, android:paddingLeft özelliği için ilişkili bir ayarlayıcı yoktur. Bunun yerine setPadding(left,
top, right, bottom) yöntemi sağlanır. BindingAdapter ek açıklamasına sahip statik bir bağlama bağdaştırıcısı yöntemi, bir özelliğin ayarlayıcısının nasıl çağrılacağını özelleştirmenize olanak tanır.
Android çerçeve sınıflarının özellikleri zaten BindingAdapter ek açıklamalarına sahip. Aşağıdaki örnekte, paddingLeft özelliği için bağlama bağdaştırıcısı gösterilmektedir:
Kotlin
@BindingAdapter("android:paddingLeft") fun setPaddingLeft(view: View, padding: Int) { view.setPadding(padding, view.getPaddingTop(), view.getPaddingRight(), view.getPaddingBottom()) }
Java
@BindingAdapter("android:paddingLeft") public static void setPaddingLeft(View view, int padding) { view.setPadding(padding, view.getPaddingTop(), view.getPaddingRight(), view.getPaddingBottom()); }
Parametre türleri önemlidir. İlk parametre, özellikle ilişkili görünümün türünü belirler. İkinci parametre, belirli bir özellik için bağlama ifadesinde kabul edilen türü belirler.
Bağlama bağdaştırıcıları, diğer özelleştirme türleri için de kullanışlıdır. Örneğin, bir resmi yüklemek için çalışan iş parçacığından özel bir yükleyici çağrılabilir.
Aşağıdaki örnekte gösterildiği gibi, birden fazla özellik alan bağdaştırıcılarınız da olabilir:
Kotlin
@BindingAdapter("imageUrl", "error") fun loadImage(view: ImageView, url: String, error: Drawable) { Picasso.get().load(url).error(error).into(view) }
Java
@BindingAdapter({"imageUrl", "error"}) public static void loadImage(ImageView view, String url, Drawable error) { Picasso.get().load(url).error(error).into(view); }
Aşağıdaki örnekte gösterildiği gibi, adaptörü düzeninizde kullanabilirsiniz. @drawable/venueError ifadesinin uygulamanızdaki bir kaynağı ifade ettiğini unutmayın. Kaynağı @{} ile çevrelemek, onu geçerli bir bağlama ifadesi haline getirir.
<ImageView app:imageUrl="@{venue.imageUrl}" app:error="@{@drawable/venueError}" />
Adaptör, bir ImageView nesnesi için imageUrl ve error kullanılıyorsa, imageUrl bir dizeyse ve error bir Drawable ise çağrılır. Özelliklerden herhangi biri ayarlandığında bağdaştırıcının çağrılmasını istiyorsanız bağdaştırıcının isteğe bağlı requireAll işaretini aşağıdaki örnekte gösterildiği gibi false olarak ayarlayın:
Kotlin
@BindingAdapter(value = ["imageUrl", "placeholder"], requireAll = false) fun setImageUrl(imageView: ImageView, url: String?, placeHolder: Drawable?) { if (url == null) { imageView.setImageDrawable(placeholder); } else { MyImageLoader.loadInto(imageView, url, placeholder); } }
Java
@BindingAdapter(value={"imageUrl", "placeholder"}, requireAll=false) public static void setImageUrl(ImageView imageView, String url, Drawable placeHolder) { if (url == null) { imageView.setImageDrawable(placeholder); } else { MyImageLoader.loadInto(imageView, url, placeholder); } }
Bağlama bağdaştırıcısı yöntemleri, işleyicilerinde eski değerleri alabilir. Eski ve yeni değerleri alan bir yöntem, önce özelliklerin tüm eski değerlerini, ardından yeni değerleri aşağıdaki örnekte gösterildiği gibi bildirmelidir:
Kotlin
@BindingAdapter("android:paddingLeft") fun setPaddingLeft(view: View, oldPadding: Int, newPadding: Int) { if (oldPadding != newPadding) { view.setPadding(newPadding, view.getPaddingTop(), view.getPaddingRight(), view.getPaddingBottom()) } }
Java
@BindingAdapter("android:paddingLeft") public static void setPaddingLeft(View view, int oldPadding, int newPadding) { if (oldPadding != newPadding) { view.setPadding(newPadding, view.getPaddingTop(), view.getPaddingRight(), view.getPaddingBottom()); } }
Etkinlik işleyiciler, yalnızca aşağıdaki örnekte gösterildiği gibi bir soyut yöntemi olan arayüzler veya soyut sınıflarla kullanılabilir:
Kotlin
@BindingAdapter("android:onLayoutChange") fun setOnLayoutChangeListener( view: View, oldValue: View.OnLayoutChangeListener?, newValue: View.OnLayoutChangeListener? ) { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) { if (oldValue != null) { view.removeOnLayoutChangeListener(oldValue) } if (newValue != null) { view.addOnLayoutChangeListener(newValue) } } }
Java
@BindingAdapter("android:onLayoutChange") public static void setOnLayoutChangeListener(View view, View.OnLayoutChangeListener oldValue, View.OnLayoutChangeListener newValue) { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) { if (oldValue != null) { view.removeOnLayoutChangeListener(oldValue); } if (newValue != null) { view.addOnLayoutChangeListener(newValue); } } }
Bu etkinlik işleyiciyi düzeninizde aşağıdaki gibi kullanın:
<View android:onLayoutChange="@{() -> handler.layoutChanged()}"/>
Birden fazla yöntemi olan dinleyiciler, birden fazla dinleyiciye bölünmelidir.
Örneğin,
View.OnAttachStateChangeListener
iki yönteme sahiptir:
onViewAttachedToWindow(View)
ve
onViewDetachedFromWindow(View).
Kitaplık, özellikleri ve bunların işleyicilerini ayırt etmek için iki arayüz sağlar:
Kotlin
// Translation from provided interfaces in Java: @TargetApi(Build.VERSION_CODES.HONEYCOMB_MR1) interface OnViewDetachedFromWindow { fun onViewDetachedFromWindow(v: View) } @TargetApi(Build.VERSION_CODES.HONEYCOMB_MR1) interface OnViewAttachedToWindow { fun onViewAttachedToWindow(v: View) }
Java
@TargetApi(VERSION_CODES.HONEYCOMB_MR1) public interface OnViewDetachedFromWindow { void onViewDetachedFromWindow(View v); } @TargetApi(VERSION_CODES.HONEYCOMB_MR1) public interface OnViewAttachedToWindow { void onViewAttachedToWindow(View v); }
Bir dinleyiciyi değiştirmek diğerini etkileyebileceğinden, her iki özellik için de çalışan bir adaptöre ihtiyacınız vardır. Aşağıdaki örnekte gösterildiği gibi, her özelliğe bir bağlama ifadesi atanması gerekmediğini belirtmek için ek açıklamada requireAll değerini false olarak ayarlayabilirsiniz:
Kotlin
@BindingAdapter( "android:onViewDetachedFromWindow", "android:onViewAttachedToWindow", requireAll = false ) fun setListener(view: View, detach: OnViewDetachedFromWindow?, attach: OnViewAttachedToWindow?) { if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB_MR1) { val newListener: View.OnAttachStateChangeListener? newListener = if (detach == null && attach == null) { null } else { object : View.OnAttachStateChangeListener { override fun onViewAttachedToWindow(v: View) { attach.onViewAttachedToWindow(v) } override fun onViewDetachedFromWindow(v: View) { detach.onViewDetachedFromWindow(v) } } } val oldListener: View.OnAttachStateChangeListener? = ListenerUtil.trackListener(view, newListener, R.id.onAttachStateChangeListener) if (oldListener != null) { view.removeOnAttachStateChangeListener(oldListener) } if (newListener != null) { view.addOnAttachStateChangeListener(newListener) } } }
Java
@BindingAdapter({"android:onViewDetachedFromWindow", "android:onViewAttachedToWindow"}, requireAll=false) public static void setListener(View view, OnViewDetachedFromWindow detach, OnViewAttachedToWindow attach) { if (VERSION.SDK_INT >= VERSION_CODES.HONEYCOMB_MR1) { OnAttachStateChangeListener newListener; if (detach == null && attach == null) { newListener = null; } else { newListener = new OnAttachStateChangeListener() { @Override public void onViewAttachedToWindow(View v) { if (attach != null) { attach.onViewAttachedToWindow(v); } } @Override public void onViewDetachedFromWindow(View v) { if (detach != null) { detach.onViewDetachedFromWindow(v); } } }; } OnAttachStateChangeListener oldListener = ListenerUtil.trackListener(view, newListener, R.id.onAttachStateChangeListener); if (oldListener != null) { view.removeOnAttachStateChangeListener(oldListener); } if (newListener != null) { view.addOnAttachStateChangeListener(newListener); } } }
Yukarıdaki örnek biraz karmaşıktır çünkü View sınıfı, OnAttachStateChangeListener için bir ayarlayıcı yöntemi yerine addOnAttachStateChangeListener() ve removeOnAttachStateChangeListener() yöntemlerini kullanır.
android.databinding.adapters.ListenerUtil sınıfı, bu dinleyicilerin takip edilmesine yardımcı olur. Böylece dinleyiciler, bağlama adaptöründen kaldırılabilir.
Nesne dönüşümleri
Otomatik nesne dönüştürme
Bir bağlama ifadesinden Object döndürüldüğünde kitaplık, özelliğin değerini ayarlamak için kullanılan yöntemi seçer. Object, seçilen yöntemin parametre türüne dönüştürülür. Bu davranış, aşağıdaki örnekte gösterildiği gibi verileri depolamak için ObservableMap sınıfını kullanan uygulamalarda kullanışlıdır:
<TextView
android:text='@{userMap["lastName"]}'
android:layout_width="wrap_content"
android:layout_height="wrap_content" />
İfadedeki userMap nesnesi bir değer döndürür. Bu değer, android:text özelliğinin değerini ayarlamak için kullanılan setText(CharSequence) yönteminde bulunan parametre türüne otomatik olarak dönüştürülür. Parametre türü belirsizse ifadedeki dönüş türünü dönüştürün.
Özel dönüşümler
Bazı durumlarda, belirli türler arasında özel dönüşüm gerekir. Örneğin, bir görünümün android:background özelliği Drawable bekler ancak belirtilen color değeri bir tam sayıdır. Aşağıdaki örnekte, Drawable bekleyen ancak bunun yerine bir tam sayı sağlanan bir özellik gösterilmektedir:
<View
android:background="@{isError ? @color/red : @color/white}"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
Drawable beklendiğinde ve bir tam sayı döndürüldüğünde int değerini ColorDrawable değerine dönüştürün.
Dönüşümü gerçekleştirmek için aşağıdaki gibi BindingConversion ek açıklaması içeren statik bir yöntem kullanın:
Kotlin
@BindingConversion fun convertColorToDrawable(color: Int) = ColorDrawable(color)
Java
@BindingConversion public static ColorDrawable convertColorToDrawable(int color) { return new ColorDrawable(color); }
Ancak bağlama ifadesinde sağlanan değer türleri tutarlı olmalıdır. Aşağıdaki örnekte gösterildiği gibi, aynı ifadede farklı türler kullanamazsınız:
// The @drawable and @color represent different value types in the same
// expression, which causes a build error.
<View
android:background="@{isError ? @drawable/error : @color/white}"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
Ek kaynaklar
Veri bağlama hakkında daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın.
Örnekler
Blog yayınları
Sizin için önerilenler
- Not: JavaScript devre dışı olduğunda bağlantı metni gösterilir.
- Veri Bağlama Kitaplığı
- Düzenler ve bağlama ifadeleri
- Görünüm bağlama