ภาษาของนิพจน์ช่วยให้คุณเขียนนิพจน์ที่จัดการเหตุการณ์ที่ส่งโดยมุมมองได้ ไลบรารีการเชื่อมโยงข้อมูลจะสร้างคลาสที่จำเป็นในการเชื่อมโยงมุมมองในเลย์เอาต์กับออบเจ็กต์ข้อมูลโดยอัตโนมัติ
ไฟล์เลย์เอาต์การเชื่อมโยงข้อมูลจะแตกต่างกันเล็กน้อยและเริ่มต้นด้วยแท็กรูทของ layout ตามด้วยองค์ประกอบ data และองค์ประกอบรูท view องค์ประกอบมุมมองนี้คือรูทในไฟล์เลย์เอาต์ที่ไม่มีการเชื่อมโยง โค้ดต่อไปนี้แสดงตัวอย่างไฟล์เลย์เอาต์
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
<data>
<variable name="user" type="com.example.User"/>
</data>
<LinearLayout
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{user.firstName}"/>
<TextView android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{user.lastName}"/>
</LinearLayout>
</layout>
ตัวแปร user ภายใน data อธิบายพร็อพเพอร์ตี้ที่ใช้ภายในเลย์เอาต์นี้ได้ ดังนี้
<variable name="user" type="com.example.User" />
นิพจน์ภายในเลย์เอาต์จะเขียนในพร็อพเพอร์ตี้แอตทริบิวต์โดยใช้ไวยากรณ์ @{} ในตัวอย่างต่อไปนี้ ข้อความ TextView จะได้รับการตั้งค่าเป็นพร็อพเพอร์ตี้ firstName ของตัวแปร user
<TextView android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{user.firstName}" />
ออบเจ็กต์ข้อมูล
สมมติว่าคุณมีออบเจ็กต์ธรรมดาเพื่ออธิบายเอนทิตี User ดังนี้
Kotlin
data class User(val firstName: String, val lastName: String)
Java
public class User { public final String firstName; public final String lastName; public User(String firstName, String lastName) { this.firstName = firstName; this.lastName = lastName; } }
ออบเจ็กต์ประเภทนี้มีข้อมูลที่ไม่เคยเปลี่ยนแปลง เป็นเรื่องปกติที่แอปจะมีข้อมูลที่อ่านเพียงครั้งเดียวและไม่เปลี่ยนแปลงหลังจากนั้น นอกจากนี้ คุณยังใช้ออบเจ็กต์ที่เป็นไปตามชุดข้อตกลงได้ด้วย เช่น การใช้วิธีเข้าถึงข้อมูลลับในภาษาโปรแกรม Java ดังที่แสดงในตัวอย่างต่อไปนี้
Kotlin
// Not applicable in Kotlin. data class User(val firstName: String, val lastName: String)
Java
public class User { private final String firstName; private final String lastName; public User(String firstName, String lastName) { this.firstName = firstName; this.lastName = lastName; } public String getFirstName() { return this.firstName; } public String getLastName() { return this.lastName; } }
ในแง่ของการเชื่อมโยงข้อมูล ทั้ง 2 คลาสนี้เทียบเท่ากัน นิพจน์ @{user.firstName} ที่ใช้สำหรับแอตทริบิวต์ android:text จะเข้าถึงช่อง firstName ในคลาสแรกและเมธอด getFirstName() ในคลาสหลัง นอกจากนี้ยังแก้ไขเป็น firstName() หากมีเมธอดดังกล่าว
ข้อมูลการเชื่อมโยง
ระบบจะสร้างคลาสการเชื่อมโยงสำหรับไฟล์เลย์เอาต์แต่ละไฟล์ โดยค่าเริ่มต้น ชื่อของคลาสจะอิงตามชื่อของไฟล์เลย์เอาต์ ซึ่งแปลงเป็นรูปแบบ Pascal Case โดยเพิ่มคำต่อท้าย Binding เข้าไป ตัวอย่างเช่น ชื่อไฟล์เลย์เอาต์ก่อนหน้าคือ activity_main.xml ดังนั้นคลาสการเชื่อมโยงที่สร้างขึ้นที่เกี่ยวข้องคือ ActivityMainBinding
คลาสนี้จะเก็บการเชื่อมโยงทั้งหมดจากพร็อพเพอร์ตี้เลย์เอาต์ เช่น ตัวแปร user ไปยังมุมมองของเลย์เอาต์ และรู้วิธีกำหนดค่าสำหรับนิพจน์การเชื่อมโยง เราขอแนะนำให้สร้างการเชื่อมโยงขณะขยายเลย์เอาต์ ดังที่แสดงในตัวอย่างต่อไปนี้
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val binding: ActivityMainBinding = DataBindingUtil.setContentView( this, R.layout.activity_main) binding.user = User("Test", "User") }
Java
@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); ActivityMainBinding binding = DataBindingUtil.setContentView(this, R.layout.activity_main); User user = new User("Test", "User"); binding.setUser(user); }
ขณะรันไทม์ แอปจะแสดงผู้ใช้ทดสอบใน UI หรือจะดูโดยใช้ LayoutInflater ก็ได้ ดังตัวอย่างต่อไปนี้
Kotlin
val binding: ActivityMainBinding = ActivityMainBinding.inflate(getLayoutInflater())
Java
ActivityMainBinding binding = ActivityMainBinding.inflate(getLayoutInflater());
หากคุณใช้รายการการเชื่อมโยงข้อมูลภายในอะแดปเตอร์ Fragment, ListView หรือ RecyclerView คุณอาจต้องการใช้เมธอด inflate() ของคลาสการเชื่อมโยงหรือคลาส DataBindingUtil ดังที่แสดงในตัวอย่างโค้ดต่อไปนี้
Kotlin
val listItemBinding = ListItemBinding.inflate(layoutInflater, viewGroup, false) // or val listItemBinding = DataBindingUtil.inflate(layoutInflater, R.layout.list_item, viewGroup, false)
Java
ListItemBinding binding = ListItemBinding.inflate(layoutInflater, viewGroup, false); // or ListItemBinding binding = DataBindingUtil.inflate(layoutInflater, R.layout.list_item, viewGroup, false);
ภาษาของนิพจน์
ฟีเจอร์ทั่วไป
ภาษาของนิพจน์จะคล้ายกับนิพจน์ที่พบในโค้ดที่มีการจัดการ คุณสามารถใช้โอเปอเรเตอร์และคีย์เวิร์ดต่อไปนี้ในภาษาของนิพจน์ได้
- คณิตศาสตร์:
+ - / * % - การเชื่อมโยงสตริง:
+ - เชิงตรรกะ:
&& || - ไบนารี:
& | ^ - Unary:
+ - ! ~ - กะ:
>> >>> << - การเปรียบเทียบ:
== > < >= <=(ต้องกำหนดอักขระหลีก<เป็น<) instanceof- การจัดกลุ่ม:
() - ลิเทอรัล เช่น อักขระ, สตริง, ตัวเลข,
null - แคสต์
- การเรียกใช้เมธอด
- การเข้าถึงระดับฟิลด์
- การเข้าถึงอาร์เรย์:
[] - โอเปอเรเตอร์ Ternary:
?:
ตัวอย่างเช่น
android:text="@{String.valueOf(index + 1)}"
android:visibility="@{age > 13 ? View.GONE : View.VISIBLE}"
android:transitionName='@{"image_" + id}'
ไม่มีการดำเนินการ
การดำเนินการต่อไปนี้ไม่มีอยู่ในไวยากรณ์นิพจน์ที่คุณใช้ในโค้ดที่มีการจัดการได้
thissupernew- การเรียกใช้ทั่วไปที่ระบุชัด
โอเปอเรเตอร์ Null Coalescing
โอเปอเรเตอร์การรวมค่า Null (??) จะเลือกตัวถูกดำเนินการทางซ้ายหากไม่ใช่ null หรือเลือกทางขวาหากตัวถูกดำเนินการก่อนหน้าเป็น null
android:text="@{user.displayName ?? user.lastName}"
ซึ่งเทียบเท่ากับฟังก์ชันต่อไปนี้
android:text="@{user.displayName != null ? user.displayName : user.lastName}"
ข้อมูลอ้างอิงเกี่ยวกับที่พัก
นิพจน์สามารถอ้างอิงพร็อพเพอร์ตี้ในคลาสได้โดยใช้รูปแบบต่อไปนี้ ซึ่งเหมือนกันสำหรับฟิลด์, Getter และออบเจ็กต์ ObservableField
android:text="@{user.lastName}"
หลีกเลี่ยง null pointer exception
โค้ดการเชื่อมโยงข้อมูลที่สร้างขึ้นจะตรวจหาค่า null โดยอัตโนมัติและหลีกเลี่ยง null pointer exception ตัวอย่างเช่น ในนิพจน์ @{user.name} หาก user เป็นค่าว่าง ระบบจะกำหนดค่าเริ่มต้นเป็น null ให้กับ user.name หากคุณอ้างอิง user.age โดยที่อายุเป็นประเภท int การเชื่อมโยงข้อมูลจะใช้ค่าเริ่มต้นเป็น 0
ดูข้อมูลอ้างอิง
นิพจน์สามารถอ้างอิงมุมมองอื่นๆ ในเลย์เอาต์ตามรหัสได้โดยใช้ไวยากรณ์ต่อไปนี้
android:text="@{exampleText.text}"
ในตัวอย่างต่อไปนี้ มุมมอง TextView อ้างอิงมุมมอง EditText ในเลย์เอาต์เดียวกัน
<EditText
android:id="@+id/example_text"
android:layout_height="wrap_content"
android:layout_width="match_parent"/>
<TextView
android:id="@+id/example_output"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{exampleText.text}"/>
คอลเล็กชัน
คุณสามารถเข้าถึงคอลเล็กชันทั่วไป เช่น อาร์เรย์ รายการ รายการแบบ Sparse และแมป โดยใช้โอเปอเรเตอร์ [] เพื่อความสะดวก
<data>
<import type="android.util.SparseArray"/>
<import type="java.util.Map"/>
<import type="java.util.List"/>
<variable name="list" type="List<String>"/>
<variable name="sparse" type="SparseArray<String>"/>
<variable name="map" type="Map<String, String>"/>
<variable name="index" type="int"/>
<variable name="key" type="String"/>
</data>
...
android:text="@{list[index]}"
...
android:text="@{sparse[index]}"
...
android:text="@{map[key]}"
นอกจากนี้ คุณยังอ้างอิงค่าในแผนที่โดยใช้สัญกรณ์ object.key ได้ด้วย เช่น คุณสามารถแทนที่ @{map[key]} ในตัวอย่างก่อนหน้าด้วย @{map.key}
ลิเทอรัลสตริง
คุณสามารถใช้เครื่องหมายคำพูดเดี่ยวเพื่อล้อมรอบค่าแอตทริบิวต์ ซึ่งจะช่วยให้คุณใช้เครื่องหมายคำพูดคู่ในนิพจน์ได้ ดังที่แสดงในตัวอย่างต่อไปนี้
android:text='@{map["firstName"]}'
นอกจากนี้ คุณยังใช้เครื่องหมายคำพูดคู่เพื่อล้อมรอบค่าแอตทริบิวต์ได้ด้วย เมื่อดำเนินการดังกล่าว สตริงลิเทอรัลต้องอยู่ภายในเครื่องหมายแบ็กทิก ` ดังที่แสดงที่นี่
android:text="@{map[`firstName`]}"
แหล่งข้อมูล
นิพจน์สามารถอ้างอิงทรัพยากรของแอปด้วยไวยากรณ์ต่อไปนี้
android:padding="@{large? @dimen/largePadding : @dimen/smallPadding}"
คุณสามารถประเมินสตริงรูปแบบและพหูพจน์ได้โดยระบุพารามิเตอร์ดังนี้
android:text="@{@string/nameFormat(firstName, lastName)}"
android:text="@{@plurals/banana(bananaCount)}"
คุณสามารถส่งการอ้างอิงพร็อพเพอร์ตี้และการอ้างอิงข้อมูลพร็อพเพอร์ตี้เป็นพารามิเตอร์ทรัพยากรได้ ดังนี้
android:text="@{@string/example_resource(user.lastName, exampleText.text)}"
เมื่อพหูพจน์ใช้พารามิเตอร์หลายรายการ ให้ส่งพารามิเตอร์ทั้งหมด ดังนี้
Have an orange
Have %d oranges
android:text="@{@plurals/orange(orangeCount, orangeCount)}"
ทรัพยากรบางอย่างต้องมีการประเมินประเภทอย่างชัดเจน ดังที่แสดงในตารางต่อไปนี้
| ประเภท | ข้อมูลอ้างอิงปกติ | ข้อมูลอ้างอิงการแสดงออกทางสีหน้า |
|---|---|---|
String[] |
@array |
@stringArray |
int[] |
@array |
@intArray |
TypedArray |
@array |
@typedArray |
Animator |
@animator |
@animator |
StateListAnimator |
@animator |
@stateListAnimator |
color int |
@color |
@color |
ColorStateList |
@color |
@colorStateList |
การจัดการเหตุการณ์
การเชื่อมโยงข้อมูลช่วยให้คุณเขียนเหตุการณ์การจัดการนิพจน์ที่ส่งมาจากมุมมองได้ เช่น เมธอด onClick() ชื่อแอตทริบิวต์เหตุการณ์จะกำหนดโดยชื่อของเมธอด Listener โดยมีข้อยกเว้นบางประการ เช่น View.OnClickListener มีเมธอด onClick() ดังนั้นแอตทริบิวต์สำหรับเหตุการณ์นี้คือ android:onClick
มีเครื่องจัดการเหตุการณ์เฉพาะบางรายการสำหรับเหตุการณ์การคลิกที่ต้องใช้แอตทริบิวต์อื่นนอกเหนือจาก android:onClick เพื่อหลีกเลี่ยงความขัดแย้ง คุณใช้แอตทริบิวต์ต่อไปนี้เพื่อหลีกเลี่ยงความขัดแย้งประเภทนี้ได้
| ชั้น | ตัวตั้งค่า Listener | แอตทริบิวต์ |
|---|---|---|
SearchView |
setOnSearchClickListener(View.OnClickListener) |
android:onSearchClick |
ZoomControls |
setOnZoomInClickListener(View.OnClickListener) |
android:onZoomIn |
ZoomControls |
setOnZoomOutClickListener(View.OnClickListener) |
android:onZoomOut |
คุณสามารถใช้กลไก 2 อย่างต่อไปนี้เพื่อจัดการเหตุการณ์ ซึ่งจะอธิบายโดยละเอียดในส่วนถัดไป
- การอ้างอิงเมธอด: ในนิพจน์ คุณสามารถอ้างอิงเมธอดที่สอดคล้องกับซิกเนเจอร์ของเมธอด Listener ได้ เมื่อนิพจน์ประเมินเป็นการอ้างอิงเมธอด การเชื่อมโยงข้อมูลจะรวมการอ้างอิงเมธอดและออบเจ็กต์เจ้าของไว้ใน Listener และตั้งค่า Listener นั้นในมุมมองเป้าหมาย หากนิพจน์ประเมินเป็น
nullการเชื่อมโยงข้อมูลจะไม่สร้าง Listener และจะตั้งค่า Listenernullแทน - การเชื่อมโยง Listener: เป็นนิพจน์ Lambda ที่จะได้รับการประเมินเมื่อเกิดเหตุการณ์ขึ้น การเชื่อมโยงข้อมูลจะสร้าง Listener เสมอ ซึ่งจะตั้งค่าไว้ในมุมมอง เมื่อส่งเหตุการณ์แล้ว Listener จะประเมินนิพจน์ Lambda
การอ้างอิงเมธอด
คุณสามารถเชื่อมโยงเหตุการณ์กับเมธอดของเครื่องจัดการได้โดยตรง คล้ายกับวิธีที่คุณสามารถกำหนด android:onClick ให้กับเมธอดในกิจกรรม ข้อดีอย่างหนึ่งเมื่อเทียบกับแอตทริบิวต์ View onClick คือระบบจะประมวลผลนิพจน์ในเวลาคอมไพล์ ดังนั้น หากไม่มีเมธอดหรือซิกเนเจอร์ไม่ถูกต้อง คุณจะได้รับข้อผิดพลาดเวลาคอมไพล์
ความแตกต่างที่สำคัญระหว่างการอ้างอิงเมธอดและการเชื่อมโยง Listener คือการใช้งาน Listener จริงจะสร้างขึ้นเมื่อมีการเชื่อมโยงข้อมูล ไม่ใช่เมื่อมีการทริกเกอร์เหตุการณ์ หากต้องการประเมินนิพจน์เมื่อเกิดเหตุการณ์ ให้ใช้การเชื่อมโยง Listener
หากต้องการกำหนดเหตุการณ์ให้กับเครื่องมือจัดการ ให้ใช้นิพจน์การเชื่อมโยงปกติ โดยมีค่าเป็นชื่อเมธอดที่จะเรียกใช้ ตัวอย่างเช่น ลองพิจารณาออบเจ็กต์ข้อมูลเลย์เอาต์ตัวอย่างต่อไปนี้
Kotlin
class MyHandlers { fun onClickFriend(view: View) { ... } }
Java
public class MyHandlers { public void onClickFriend(View view) { ... } }
นิพจน์การเชื่อมโยงสามารถกำหนดฟังก์ชันรอคลิกสำหรับมุมมองให้กับเมธอด onClickFriend() ได้ดังนี้
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
<data>
<variable name="handlers" type="com.example.MyHandlers"/>
<variable name="user" type="com.example.User"/>
</data>
<LinearLayout
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="@{user.firstName}"
android:onClick="@{handlers::onClickFriend}"/>
</LinearLayout>
</layout>
การเชื่อมโยง Listener
การเชื่อมโยง Listener คือนิพจน์การเชื่อมโยงที่ทำงานเมื่อเกิดเหตุการณ์ ซึ่งคล้ายกับการอ้างอิงเมธอด แต่ช่วยให้คุณเรียกใช้นิพจน์การเชื่อมโยงข้อมูลที่กำหนดเองได้ ฟีเจอร์นี้ใช้ได้กับปลั๊กอิน Android Gradle สำหรับ Gradle เวอร์ชัน 2.0 ขึ้นไป
ในการอ้างอิงเมธอด พารามิเตอร์ของเมธอดต้องตรงกับพารามิเตอร์ของ Listener เหตุการณ์ ในการเชื่อมโยง Listener เฉพาะค่าที่แสดงผลของคุณเท่านั้นที่ต้องตรงกับค่าที่แสดงผลที่คาดไว้ของ Listener เว้นแต่จะคาดหวัง void ตัวอย่างเช่น ลองพิจารณาคลาสผู้นำเสนอต่อไปนี้ซึ่งมีเมธอด onSaveClick()
Kotlin
class Presenter { fun onSaveClick(task: Task){} }
Java
public class Presenter { public void onSaveClick(Task task){} }
คุณสามารถเชื่อมโยงกิจกรรมการคลิกกับเมธอด onSaveClick() ได้ดังนี้
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
<data>
<variable name="task" type="com.android.example.Task" />
<variable name="presenter" type="com.android.example.Presenter" />
</data>
<LinearLayout android:layout_width="match_parent" android:layout_height="match_parent">
<Button android:layout_width="wrap_content" android:layout_height="wrap_content"
android:onClick="@{() -> presenter.onSaveClick(task)}" />
</LinearLayout>
</layout>
เมื่อใช้ Callback ในนิพจน์ การเชื่อมโยงข้อมูลจะสร้าง Listener ที่จำเป็นและลงทะเบียนสำหรับเหตุการณ์โดยอัตโนมัติ เมื่อมุมมองเริ่มเหตุการณ์ การเชื่อมโยงข้อมูลจะประเมินนิพจน์ที่ระบุ เช่นเดียวกับนิพจน์การเชื่อมโยงปกติ คุณจะได้รับความปลอดภัยของเธรดและการเชื่อมโยงข้อมูลเป็นค่า Null ขณะที่ระบบประเมินนิพจน์ Listener เหล่านี้
ในตัวอย่างก่อนหน้านี้ ไม่ได้กำหนดพารามิเตอร์ view ที่ส่งไปยัง onClick(View) การเชื่อมโยง Listener มีตัวเลือก 2 รายการสำหรับพารามิเตอร์ Listener ได้แก่ คุณสามารถละเว้นพารามิเตอร์ทั้งหมดไปยังเมธอดหรือตั้งชื่อพารามิเตอร์ทั้งหมด หากต้องการตั้งชื่อพารามิเตอร์ คุณสามารถใช้พารามิเตอร์เหล่านั้นในนิพจน์ได้ เช่น คุณสามารถเขียนนิพจน์ก่อนหน้าได้ดังนี้
android:onClick="@{(view) -> presenter.onSaveClick(task)}"
หากต้องการใช้พารามิเตอร์ในนิพจน์ ให้ทำดังนี้
Kotlin
class Presenter { fun onSaveClick(view: View, task: Task){} }
Java
public class Presenter { public void onSaveClick(View view, Task task){} }
android:onClick="@{(theView) -> presenter.onSaveClick(theView, task)}"
และคุณสามารถใช้นิพจน์ lambda ที่มีพารามิเตอร์มากกว่า 1 รายการได้ ดังนี้
Kotlin
class Presenter { fun onCompletedChanged(task: Task, completed: Boolean){} }
Java
public class Presenter { public void onCompletedChanged(Task task, boolean completed){} }
<CheckBox android:layout_width="wrap_content" android:layout_height="wrap_content"
android:onCheckedChanged="@{(cb, isChecked) -> presenter.completeChanged(task, isChecked)}" />
หากเหตุการณ์ที่คุณกำลังฟังแสดงผลค่าที่มีประเภทไม่ใช่ void นิพจน์ของคุณต้องแสดงผลค่าประเภทเดียวกันด้วย เช่น หากต้องการฟังเหตุการณ์แตะค้างไว้ (คลิกค้าง) นิพจน์ต้องแสดงผลเป็นบูลีน
Kotlin
class Presenter { fun onLongClick(view: View, task: Task): Boolean { } }
Java
public class Presenter { public boolean onLongClick(View view, Task task) { } }
android:onLongClick="@{(theView) -> presenter.onLongClick(theView, task)}"
หากประเมินนิพจน์ไม่ได้เนื่องจากออบเจ็กต์ null การเชื่อมโยงข้อมูลจะแสดงผลค่าเริ่มต้นสำหรับประเภทนั้น เช่น null สำหรับประเภทการอ้างอิง 0 สำหรับ int หรือ false สำหรับ boolean
หากต้องการใช้นิพจน์ที่มีเพรดิเคต เช่น เทอร์นารี คุณสามารถใช้ void เป็นสัญลักษณ์ได้ ดังนี้
android:onClick="@{(v) -> v.isVisible() ? doSomething() : void}"
หลีกเลี่ยง Listener ที่ซับซ้อน
นิพจน์ Listener มีประสิทธิภาพและช่วยให้อ่านโค้ดได้ง่ายขึ้น ในทางกลับกัน Listener ที่มีนิพจน์ที่ซับซ้อนจะทำให้เลย์เอาต์อ่านและดูแลรักษาได้ยากขึ้น เขียนนิพจน์ให้เรียบง่ายที่สุด เช่น การส่งข้อมูลที่มีอยู่จาก UI ไปยังเมธอด Callback ใช้ตรรกะทางธุรกิจภายในเมธอด Callback ที่คุณเรียกใช้จากนิพจน์ Listener
การนำเข้า ตัวแปร และการรวม
ไลบรารีการเชื่อมโยงข้อมูลมีฟีเจอร์ต่างๆ เช่น การนําเข้า ตัวแปร และการรวม การนำเข้าจะสร้างคลาสที่อ้างอิงได้ง่ายภายในไฟล์เลย์เอาต์ ตัวแปรช่วยให้คุณอธิบายพร็อพเพอร์ตี้ที่ใช้ในนิพจน์การเชื่อมโยงได้ Includes ช่วยให้คุณนำเลย์เอาต์ที่ซับซ้อนมาใช้ซ้ำในแอปได้
การนำเข้า
การนำเข้าช่วยให้คุณอ้างอิงคลาสภายในไฟล์เลย์เอาต์ได้ เช่น ในโค้ดที่มีการจัดการ
คุณสามารถใช้องค์ประกอบ import ได้ตั้งแต่ 0 รายการขึ้นไปภายในองค์ประกอบ data ตัวอย่างโค้ดต่อไปนี้จะนำเข้าคลาส View ไปยังไฟล์เลย์เอาต์
<data>
<import type="android.view.View"/>
</data>
การนำเข้าคลาส View ช่วยให้คุณอ้างอิงคลาสดังกล่าวจากนิพจน์การเชื่อมโยงได้
ตัวอย่างต่อไปนี้แสดงวิธีอ้างอิงค่าคงที่ VISIBLE และ GONE ของคลาส View
<TextView
android:text="@{user.lastName}"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:visibility="@{user.isAdult ? View.VISIBLE : View.GONE}"/>
ชื่อแทนประเภท
เมื่อชื่อชั้นเรียนขัดแย้งกัน คุณสามารถเปลี่ยนชื่อชั้นเรียนหนึ่งเป็นชื่อแทนได้ ตัวอย่างต่อไปนี้จะเปลี่ยนชื่อคลาส View ในแพ็กเกจ com.example.real.estate เป็น Vista
<import type="android.view.View"/>
<import type="com.example.real.estate.View"
alias="Vista"/>
จากนั้นคุณจะใช้ Vista เพื่ออ้างอิง com.example.real.estate.View และ View เพื่ออ้างอิง android.view.View ภายในไฟล์เลย์เอาต์ได้
นำเข้าชั้นเรียนอื่นๆ
คุณสามารถใช้ประเภทที่นำเข้าเป็นข้อมูลอ้างอิงประเภทในตัวแปรและนิพจน์ได้ ตัวอย่างต่อไปนี้แสดงการใช้ User และ List เป็นประเภทของตัวแปร
<data>
<import type="com.example.User"/>
<import type="java.util.List"/>
<variable name="user" type="User"/>
<variable name="userList" type="List<User>"/>
</data>
คุณสามารถใช้ประเภทที่นำเข้าเพื่อแคสต์ส่วนหนึ่งของนิพจน์ได้ ตัวอย่างต่อไปนี้จะแคสต์พร็อพเพอร์ตี้ connection เป็นประเภท User
<TextView
android:text="@{((User)(user.connection)).lastName}"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
นอกจากนี้ คุณยังใช้ประเภทที่นำเข้าเมื่ออ้างอิงฟิลด์และเมธอดแบบคงที่ในนิพจน์ได้ด้วย โค้ดต่อไปนี้จะนำเข้าคลาส MyStringUtils และอ้างอิงเมธอด capitalize
<data>
<import type="com.example.MyStringUtils"/>
<variable name="user" type="com.example.User"/>
</data>
…
<TextView
android:text="@{MyStringUtils.capitalize(user.lastName)}"
android:layout_width="wrap_content"
android:layout_height="wrap_content"/>
ระบบจะนำเข้า java.lang.* โดยอัตโนมัติเช่นเดียวกับในโค้ดที่มีการจัดการ
ตัวแปร
คุณใช้องค์ประกอบ variable หลายรายการภายในองค์ประกอบ data ได้ องค์ประกอบ variable แต่ละรายการจะอธิบายพร็อพเพอร์ตี้ที่ตั้งค่าได้ในเลย์เอาต์เพื่อใช้ในนิพจน์การเชื่อมโยงภายในไฟล์เลย์เอาต์ ตัวอย่างต่อไปนี้ประกาศตัวแปร user, image และ note
<data>
<import type="android.graphics.drawable.Drawable"/>
<variable name="user" type="com.example.User"/>
<variable name="image" type="Drawable"/>
<variable name="note" type="String"/>
</data>
ระบบจะตรวจสอบประเภทตัวแปรในเวลาคอมไพล์ ดังนั้นหากตัวแปรใช้ Observable หรือเป็นคอลเล็กชันที่สังเกตได้ ก็ต้องแสดงให้เห็นในประเภทนั้น หากตัวแปรเป็นคลาสพื้นฐานหรืออินเทอร์เฟซที่ไม่ได้ใช้อินเทอร์เฟซ Observable ระบบจะไม่สังเกตตัวแปร
เมื่อมีไฟล์เลย์เอาต์ที่แตกต่างกันสำหรับการกำหนดค่าต่างๆ (เช่น แนวนอนหรือแนวตั้ง) ระบบจะรวมตัวแปรเข้าด้วยกัน ต้องไม่มีคำจำกัดความของตัวแปรที่ขัดแย้งกันระหว่างไฟล์เลย์เอาต์เหล่านี้
คลาสการเชื่อมโยงที่สร้างขึ้นจะมี Setter และ Getter สำหรับตัวแปรที่อธิบายแต่ละรายการ ตัวแปรจะใช้ค่าโค้ดที่มีการจัดการเริ่มต้นจนกว่าจะมีการเรียกใช้ Setter ซึ่งก็คือ null สำหรับประเภทการอ้างอิง 0 สำหรับ int false สำหรับ boolean เป็นต้น
ระบบจะสร้างตัวแปรพิเศษชื่อ context เพื่อใช้ในนิพจน์การเชื่อมโยงตามต้องการ ค่าของ context คือออบเจ็กต์ Context จากเมธอด getContext() ของมุมมองรูท ตัวแปร context ถูกลบล้างโดยการประกาศตัวแปรที่ชัดเจนซึ่งมีชื่อนั้น
รวม
คุณสามารถส่งตัวแปรไปยังการเชื่อมโยงของเลย์เอาต์ที่รวมไว้จากเลย์เอาต์ที่มีอยู่ได้โดยใช้เนมสเปซของแอปและชื่อตัวแปรในแอตทริบิวต์ ตัวอย่างต่อไปนี้แสดงตัวแปร user ที่รวมไว้จากไฟล์เลย์เอาต์ name.xml และ contact.xml
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:bind="http://schemas.android.com/apk/res-auto">
<data>
<variable name="user" type="com.example.User"/>
</data>
<LinearLayout
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="match_parent">
<include layout="@layout/name"
bind:user="@{user}"/>
<include layout="@layout/contact"
bind:user="@{user}"/>
</LinearLayout>
</layout>
การเชื่อมโยงข้อมูลไม่รองรับการรวมเป็นองค์ประกอบย่อยโดยตรงขององค์ประกอบผสาน ตัวอย่างเช่น ระบบไม่รองรับเลย์เอาต์ต่อไปนี้
<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:bind="http://schemas.android.com/apk/res-auto">
<data>
<variable name="user" type="com.example.User"/>
</data>
<merge><!-- Doesn't work -->
<include layout="@layout/name"
bind:user="@{user}"/>
<include layout="@layout/contact"
bind:user="@{user}"/>
</merge>
</layout>
แหล่งข้อมูลเพิ่มเติม
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเชื่อมโยงข้อมูลได้ที่แหล่งข้อมูลเพิ่มเติมต่อไปนี้