การออกแบบและการเชื่อมโยงนิพจน์

ภาษาของนิพจน์ช่วยให้คุณเขียนนิพจน์ที่จัดการเหตุการณ์ที่ส่งโดยมุมมองได้ ไลบรารีการเชื่อมโยงข้อมูลจะสร้างคลาสที่จำเป็นในการเชื่อมโยงมุมมองในเลย์เอาต์กับออบเจ็กต์ข้อมูลโดยอัตโนมัติ

ไฟล์เลย์เอาต์การเชื่อมโยงข้อมูลจะแตกต่างกันเล็กน้อยและเริ่มต้นด้วยแท็กรูทของ 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: + - ! ~
  • กะ: >> >>> <<
  • การเปรียบเทียบ: == > < >= <= (ต้องกำหนดอักขระหลีก < เป็น &lt;)
  • instanceof
  • การจัดกลุ่ม: ()
  • ลิเทอรัล เช่น อักขระ, สตริง, ตัวเลข, null
  • แคสต์
  • การเรียกใช้เมธอด
  • การเข้าถึงระดับฟิลด์
  • การเข้าถึงอาร์เรย์: []
  • โอเปอเรเตอร์ Ternary: ?:

ตัวอย่างเช่น

android:text="@{String.valueOf(index + 1)}"
android:visibility="@{age > 13 ? View.GONE : View.VISIBLE}"
android:transitionName='@{"image_" + id}'

ไม่มีการดำเนินการ

การดำเนินการต่อไปนี้ไม่มีอยู่ในไวยากรณ์นิพจน์ที่คุณใช้ในโค้ดที่มีการจัดการได้

  • this
  • super
  • new
  • การเรียกใช้ทั่วไปที่ระบุชัด

โอเปอเรเตอร์ 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&lt;String>"/>
    <variable name="sparse" type="SparseArray&lt;String>"/>
    <variable name="map" type="Map&lt;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 และจะตั้งค่า Listener null แทน
  • การเชื่อมโยง 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&lt;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>

แหล่งข้อมูลเพิ่มเติม

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเชื่อมโยงข้อมูลได้ที่แหล่งข้อมูลเพิ่มเติมต่อไปนี้

ตัวอย่าง

บล็อกโพสต์