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

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

ไฟล์เลย์เอาต์การเชื่อมโยงข้อมูลจะแตกต่างกันเล็กน้อยและเริ่มต้นด้วยแท็กรากของ 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;   } }

จากมุมมองของการเชื่อมโยงข้อมูล คลาสทั้งสองนี้เทียบเท่ากัน นิพจน์ @{user.firstName} ที่ใช้สำหรับ android:text เข้าถึงฟิลด์ firstName ในคลาสเดิมและ getFirstName() ในคลาสหลัง และยังเป็น firstName() หากมีวิธีการดังกล่าว

การเชื่อมโยงข้อมูล

ระบบจะสร้างคลาสการเชื่อมโยงสำหรับไฟล์เลย์เอาต์แต่ละไฟล์ โดยค่าเริ่มต้น ชื่อของ จะอิงตามชื่อไฟล์เลย์เอาต์ที่แปลงเป็นตัวพิมพ์เล็ก/ใหญ่แบบ Pascal จะมีการเพิ่มคำต่อท้ายการเชื่อมโยงไว้ ตัวอย่างเช่น ชื่อไฟล์ของเลย์เอาต์ก่อนหน้าคือ 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);

ภาษานิพจน์

ฟีเจอร์ทั่วไป

ภาษานิพจน์มีลักษณะคล้ายกับนิพจน์ที่พบในโค้ดที่มีการจัดการ คุณ สามารถใช้โอเปอเรเตอร์และคีย์เวิร์ดต่อไปนี้ในภาษานิพจน์

  • คณิตศาสตร์: + - / * %
  • การต่อสตริง: +
  • ตรรกะ: && ||
  • ไบนารี: & | ^
  • ค่าเดี่ยว: + - ! ~
  • Shift: >> >>> <<
  • การเปรียบเทียบ: == > < >= <= (ต้อง Escape < เป็น &lt;)
  • instanceof
  • การจัดกลุ่ม: ()
  • ลิเทอรัล เช่น อักขระ สตริง ตัวเลข null
  • แคสต์
  • การเรียกเมธอด
  • สิทธิ์เข้าถึงช่อง
  • การเข้าถึงอาร์เรย์: []
  • โอเปอเรเตอร์สามส่วน: ?:

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

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

การดำเนินการที่ขาดหายไป

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

  • this
  • super
  • new
  • การเรียกใช้ทั่วไปที่อาจไม่เหมาะสม

โอเปอเรเตอร์การรวมศูนย์

โอเปอเรเตอร์การรวมค่าว่าง (??) เลือกตัวถูกดำเนินการด้านซ้ายหากไม่ใช่ null หรือทางขวาหากอันแรกคือ null

android:text="@{user.displayName ?? user.lastName}"

ซึ่งมีฟังก์ชันการทำงานเทียบเท่ากับรายการต่อไปนี้

android:text="@{user.displayName != null ? user.displayName : user.lastName}"

การอ้างอิงพร็อพเพอร์ตี้

นิพจน์สามารถอ้างอิงพร็อพเพอร์ตี้ในคลาสได้โดยใช้รูปแบบต่อไปนี้ ซึ่งจะเหมือนกันสำหรับฟิลด์, Getters และ ObservableField ออบเจ็กต์มีดังนี้

android:text="@{user.lastName}"

หลีกเลี่ยงข้อยกเว้นตัวชี้ Null

โค้ดการเชื่อมโยงข้อมูลที่สร้างขึ้นจะตรวจสอบค่า null โดยอัตโนมัติและหลีกเลี่ยง ข้อยกเว้นตัวชี้ค่าว่าง ตัวอย่างเช่น ในนิพจน์ @{user.name} หาก user เป็นค่าว่าง user.name มีการกำหนดค่าเริ่มต้นเป็น null หากคุณ อ้างอิง 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}"/>

คอลเล็กชัน

คุณสามารถเข้าถึงคอลเล็กชันทั่วไป เช่น อาร์เรย์ รายการ รายการแบบกระจัดกระจาย และ แผนที่ โดยใช้โอเปอเรเตอร์ [] เพื่อความสะดวก

<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: นิพจน์เหล่านี้คือนิพจน์แลมบ์ดาที่ จะได้รับการประเมินเมื่อเกิดเหตุการณ์ขึ้น การเชื่อมโยงข้อมูลจะสร้าง Listener ซึ่งตั้งค่าไว้ในมุมมอง เมื่อมีการส่งเหตุการณ์ พารามิเตอร์ Listener จะประเมินนิพจน์แลมบ์ดา

การอ้างอิงเมธอด

คุณสามารถเชื่อมโยงเหตุการณ์กับเมธอดเครื่องจัดการได้โดยตรง ซึ่งคล้ายกับวิธีที่คุณทำได้ กำหนด android:onClick เป็น ในกิจกรรม ข้อได้เปรียบหนึ่งข้อเทียบกับ View onClick แอตทริบิวต์คือ นิพจน์จะถูกประมวลผลในเวลาคอมไพล์ ดังนั้น ถ้าไม่พบเมธอดหรือ ลายเซ็นไม่ถูกต้อง คุณได้รับข้อผิดพลาดเกี่ยวกับเวลาคอมไพล์

ความแตกต่างสำคัญระหว่างการอ้างอิงเมธอดและการเชื่อมโยงผู้ฟังคือ การติดตั้งใช้งาน Listener จริงจะสร้างขึ้นเมื่อมีการเชื่อมโยงข้อมูล ไม่ใช่เมื่อมีการเชื่อมโยง ทริกเกอร์เหตุการณ์ หากต้องการประเมินนิพจน์เมื่อเหตุการณ์ ให้ใช้การเชื่อมโยงผู้ฟัง

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

Kotlin

 class MyHandlers {     fun onClickFriend(view: View) { ... } }

Java

 public class MyHandlers {     public void onClickFriend(View view) { ... } }

นิพจน์การเชื่อมโยงสามารถกำหนด Listener การคลิกสำหรับมุมมองให้กับฟังก์ชัน 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 เฉพาะค่าผลลัพธ์เท่านั้นที่ต้องตรงกับ ผลลัพธ์ที่คาดไว้ของผู้ฟัง เว้นแต่ว่าจะคาดหวัง 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 และเทรดของการผูกข้อมูล ก็กำลังประเมินนิพจน์ของผู้ฟังอยู่

ในตัวอย่างก่อนหน้านี้ พารามิเตอร์ view ที่ส่งไปยัง onClick(View) ไม่ได้กำหนดไว้ การเชื่อมโยงผู้ฟังมี 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 ค่า นิพจน์จะต้องแสดงผลค่าประเภทเดียวกันด้วย ตัวอย่างเช่น ถ้าคุณต้องการ เพื่อฟังการสัมผัสและ Hold (คลิกยาว) นิพจน์จะต้องแสดงผลเป็น บูลีน

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}"

หลีกเลี่ยงผู้ฟังที่ซับซ้อน

นิพจน์ของผู้ฟังมีประสิทธิภาพและทำให้โค้ดอ่านง่ายขึ้น ใน ในทางกลับกัน ผู้ฟังที่มีสีหน้าที่ซับซ้อนจะทำให้เลย์เอาต์ของคุณยากขึ้น ในการอ่านและดูแลรักษา ทำให้นิพจน์ของคุณเรียบง่ายด้วยการส่งข้อมูลที่มี จาก UI ไปยังเมธอด Callback ใช้ตรรกะทางธุรกิจภายใน เมธอด Callback ที่คุณเรียกใช้จากนิพจน์ Listener

การนําเข้า ตัวแปร และรวมถึง

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

การนำเข้า

การนำเข้าช่วยให้คุณอ้างอิงคลาสภายในไฟล์เลย์เอาต์ได้ เช่น ในโค้ดที่มีการจัดการ คุณจะใช้องค์ประกอบ import ภายในองค์ประกอบ data จำนวน 0 รายการขึ้นไปได้ ตัวอย่างโค้ดต่อไปนี้นำเข้าคลาส 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 ตัวแปรจะไม่ สังเกตการณ์แล้ว

เมื่อมีไฟล์เลย์เอาต์ที่แตกต่างกันสำหรับการกำหนดค่าต่างๆ (เช่น แนวนอนหรือแนวตั้ง) ระบบจะรวมตัวแปรเข้าด้วยกัน ต้องไม่มี คำจำกัดความของตัวแปรที่ขัดแย้งกันระหว่างไฟล์เลย์เอาต์เหล่านี้

คลาสการเชื่อมโยงที่สร้างขึ้นมีตัวตั้งค่าและ Getter สำหรับแต่ละรายการที่อธิบาย ตัวแปร ตัวแปรจะใช้ค่าโค้ดที่มีการจัดการเริ่มต้นจนกว่าตัวตั้งค่า เรียกว่า — 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>

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

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

ตัวอย่าง

Codelab

บล็อกโพสต์