การเชื่อมโยงมุมมอง   เป็นส่วนหนึ่งของ Android Jetpack

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

ในกรณีส่วนใหญ่ การเชื่อมโยงมุมมองจะแทนที่ findViewById

ตั้งค่า

การเชื่อมโยงมุมมองจะเปิดใช้ทีละโมดูล หากต้องการเปิดใช้การเชื่อมโยงมุมมองในข้อบังคับ ให้ตั้งค่าตัวเลือกการสร้าง viewBinding เป็น true ในไฟล์ build.gradle ระดับข้อบังคับ ดังที่แสดงในตัวอย่างต่อไปนี้

android {
    ...
    buildFeatures {
        viewBinding true
    }
}

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

หากต้องการให้ระบบละเว้นไฟล์เลย์เอาต์ขณะสร้างคลาสการเชื่อมโยง ให้เพิ่มแอตทริบิวต์ tools:viewBindingIgnore="true" ลงในมุมมองรูทของไฟล์เลย์เอาต์นั้น

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

การใช้งาน

หากเปิดใช้การเชื่อมโยงมุมมองสําหรับโมดูล ระบบจะสร้างคลาสการเชื่อมโยงสําหรับไฟล์เลย์เอาต์ XML แต่ละไฟล์ที่โมดูลมี คลาสการเชื่อมโยงแต่ละคลาสมีการอ้างอิงถึงมุมมองรูทและมุมมองทั้งหมดที่มีรหัส ระบบจะสร้างชื่อคลาสการเชื่อมโยงโดยแปลงชื่อไฟล์ XML เป็นรูปแบบ Pascal Case และเพิ่มคําว่า "Binding" ต่อท้าย

ตัวอย่างเช่น ลองพิจารณาไฟล์เลย์เอาต์ชื่อ result_profile.xml ที่มีข้อมูลต่อไปนี้

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

คลาสการเชื่อมโยงที่สร้างขึ้นจะเรียกว่า ResultProfileBinding คลาสนี้มี 2 ช่อง ได้แก่ TextView ชื่อ name และ Button ชื่อ button ImageView ในเลย์เอาต์ไม่มีรหัส จึงไม่มีการอ้างอิงถึงในคลาสการเชื่อมโยง

คลาสการเชื่อมโยงทุกคลาสยังมีเมธอด getRoot() ด้วย ซึ่งให้การอ้างอิงโดยตรงสำหรับมุมมองรูทของไฟล์เลย์เอาต์ที่เกี่ยวข้อง ในตัวอย่างนี้ getRoot() จะแสดงผลLinearLayout มุมมองรูทในคลาส ResultProfileBinding

ส่วนต่อไปนี้จะแสดงการใช้คลาสการเชื่อมโยงที่สร้างขึ้นในแอปพลิเคชันและฟragment

ใช้การเชื่อมโยงมุมมองในกิจกรรม

หากต้องการตั้งค่าอินสแตนซ์ของคลาสการเชื่อมโยงเพื่อใช้กับกิจกรรม ให้ทําตามขั้นตอนต่อไปนี้ในเมธอด onCreate() ของกิจกรรม

1. เรียกใช้เมธอด inflate() แบบคงที่ซึ่งรวมอยู่ในคลาสการเชื่อมโยงที่สร้างขึ้น ซึ่งจะสร้างอินสแตนซ์ของคลาสการเชื่อมโยงเพื่อให้กิจกรรมใช้
2. รับการอ้างอิงไปยังมุมมองรูทโดยการเรียกใช้เมธอด getRoot() หรือใช้ไวยากรณ์พร็อพเพอร์ตี้ Kotlin
3. ส่งมุมมองรูทไปที่ setContentView() เพื่อทําให้เป็นมุมมองที่ใช้งานอยู่บนหน้าจอ

ขั้นตอนเหล่านี้แสดงอยู่ในตัวอย่างต่อไปนี้

private lateinit var binding: ResultProfileBinding

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

private ResultProfileBinding binding;

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

ตอนนี้คุณใช้อินสแตนซ์ของคลาสการเชื่อมโยงเพื่ออ้างอิงมุมมองใดก็ได้ ดังนี้

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

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

ใช้การเชื่อมโยงมุมมองในส่วนย่อย

หากต้องการตั้งค่าอินสแตนซ์ของคลาสการเชื่อมโยงเพื่อใช้กับ FRG ให้ทําตามขั้นตอนต่อไปนี้ในเมธอด onCreateView() ของ FRG

1. เรียกใช้เมธอด inflate() แบบคงที่ซึ่งรวมอยู่ในคลาสการเชื่อมโยงที่สร้างขึ้น การดำเนินการนี้จะสร้างอินสแตนซ์ของคลาสการเชื่อมโยงเพื่อให้ส่วนที่ตัดออกมาใช้
2. รับการอ้างอิงไปยังมุมมองรูทโดยการเรียกใช้เมธอด getRoot() หรือใช้ไวยากรณ์พร็อพเพอร์ตี้ Kotlin
3. แสดงผลมุมมองรูทจากเมธอด onCreateView() เพื่อให้เป็นมุมมองที่ใช้งานอยู่บนหน้าจอ

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
}

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

ตอนนี้คุณใช้อินสแตนซ์ของคลาสการเชื่อมโยงเพื่ออ้างอิงมุมมองใดก็ได้ ดังนี้

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

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

ระบุคำแนะนำสำหรับการกำหนดค่าต่างๆ

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

# in res/layout/example.xml

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

# in res/layout-land/example.xml

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

ในกรณีนี้ คุณอาจคาดหวังว่าคลาสที่สร้างขึ้นจะแสดงฟิลด์ userBio ที่มีประเภท TextView เนื่องจาก TextView เป็นคลาสฐานทั่วไป เนื่องจากข้อจํากัดทางเทคนิค ตัวสร้างโค้ดการเชื่อมโยงมุมมองจึงไม่สามารถระบุข้อมูลนี้ได้และจะสร้างช่อง View แทน ซึ่งจะต้องแคสต์ฟิลด์ในภายหลังด้วย binding.userBio as TextView

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

อีกตัวอย่างหนึ่งคือ สมมติว่าคุณมีเลย์เอาต์ 2 รายการ รายการหนึ่งมี BottomNavigationView และอีกรายการมี NavigationRailView ทั้ง 2 คลาสจะขยาย NavigationBarView ซึ่งมีรายละเอียดการใช้งานส่วนใหญ่ หากโค้ดไม่จำเป็นต้องทราบว่ามีคลาสย่อยใดอยู่ในเลย์เอาต์ปัจจุบันบ้าง คุณสามารถใช้ tools:viewBindingType เพื่อตั้งค่าประเภทที่สร้างขึ้นเป็น NavigationBarView ในทั้ง 2 เลย์เอาต์ ดังนี้

# 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" />

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

• ค่าต้องเป็นคลาสที่รับค่ามาจาก android.view.View

• ค่าต้องเป็นซุปเปอร์คลาสของแท็กที่วางไว้ เช่น ค่าต่อไปนี้ใช้ไม่ได้

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

• ประเภทสุดท้ายต้องแก้ไขให้สอดคล้องกันในการกําหนดค่าทั้งหมด

ความแตกต่างจาก findViewById

การเชื่อมโยงมุมมองมีข้อดีที่สำคัญเหนือกว่าการใช้ findViewById ดังนี้

• ความปลอดภัยจากค่า Null: เนื่องจากการเชื่อมโยงข้อมูลวิวจะสร้างการอ้างอิงโดยตรงไปยังวิว จึงไม่มีความเสี่ยงที่จะเกิดข้อยกเว้นเกี่ยวกับ Null Pointer เนื่องจากรหัสวิวไม่ถูกต้อง นอกจากนี้ เมื่อมุมมองปรากฏในบางการกำหนดค่าของเลย์เอาต์เท่านั้น ระบบจะทําเครื่องหมายช่องที่มีข้อมูลอ้างอิงในคลาสการเชื่อมโยงด้วย @Nullable
• ความปลอดภัยของประเภท: ฟิลด์ในคลาสการเชื่อมโยงแต่ละคลาสมีประเภทที่ตรงกับมุมมองที่อ้างอิงในไฟล์ XML ซึ่งหมายความว่าไม่มีความเสี่ยงที่จะเกิดข้อยกเว้นการแคสต์คลาส

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

การเปรียบเทียบกับการเชื่อมโยงข้อมูล

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

• การคอมไพล์เร็วขึ้น: การเชื่อมโยงข้อมูลพร็อพเพอร์ตี้ของวิวไม่จําเป็นต้องประมวลผลการกำกับเนื้อหา ดังนั้นเวลาในการคอมไพล์จึงเร็วขึ้น
• ใช้งานง่าย: การเชื่อมโยงข้อมูลวิวไม่จําเป็นต้องใช้ไฟล์เลย์เอาต์ XML ที่มีแท็กพิเศษ จึงนำไปใช้ในแอปได้เร็วขึ้น เมื่อเปิดใช้การเชื่อมโยงมุมมองในโมดูลแล้ว การเชื่อมโยงจะมีผลกับเลย์เอาต์ทั้งหมดของโมดูลนั้นโดยอัตโนมัติ

ในทางกลับกัน การเชื่อมโยงข้อมูลมีข้อจํากัดต่อไปนี้เมื่อเทียบกับการเชื่อมโยงข้อมูล

• การเชื่อมโยงมุมมองไม่รองรับตัวแปรเลย์เอาต์หรือนิพจน์เลย์เอาต์ จึงใช้เพื่อประกาศเนื้อหา UI แบบไดนามิกจากไฟล์เลย์เอาต์ XML ได้โดยตรง
• การเชื่อมโยงข้อมูลไม่รองรับการเชื่อมโยงข้อมูลแบบ 2 ทาง

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

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

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

บล็อก

• ใช้การเชื่อมโยงมุมมองเพื่อแทนที่ findViewById

วิดีโอ

• Android Jetpack: แทนที่ findViewById ด้วย View Binding