ปรับแต่งรายการแบบไดนามิก เป็นส่วนหนึ่งของ Android Jetpack
คุณปรับแต่ง
RecyclerView
ออบเจ็กต์ให้เหมาะกับความต้องการเฉพาะได้ คลาสมาตรฐานที่อธิบายไว้ในส่วนสร้างรายการแบบไดนามิกด้วย RecyclerView มีฟังก์ชันทั้งหมดที่นักพัฒนาซอฟต์แวร์ส่วนใหญ่ต้องการ ในหลายกรณี คุณเพียงต้องออกแบบมุมมองสําหรับตัวยึดตำแหน่งแต่ละรายการและเขียนโค้ดเพื่ออัปเดตมุมมองเหล่านั้นด้วยข้อมูลที่เหมาะสม อย่างไรก็ตาม หากแอปมีข้อกําหนดเฉพาะ คุณสามารถแก้ไขลักษณะการทํางานมาตรฐานได้หลายวิธี
เอกสารนี้อธิบายการกำหนดค่าที่เป็นไปได้บางส่วน
แก้ไขเลย์เอาต์
RecyclerView
ใช้ตัวจัดการเลย์เอาต์เพื่อจัดตำแหน่งแต่ละรายการบนหน้าจอและกำหนดเวลาที่จะนำมุมมองรายการที่ผู้ใช้ไม่เห็นแล้วกลับมาใช้ใหม่ หากต้องการนํามุมมองมาใช้ซ้ำหรือรีไซเคิล ผู้จัดการเลย์เอาต์อาจขอให้อะแดปเตอร์แทนที่เนื้อหาของมุมมองด้วยองค์ประกอบอื่นจากชุดข้อมูล มุมมองการรีไซเคิลจะช่วยปรับปรุงประสิทธิภาพโดยหลีกเลี่ยงการสร้างมุมมองที่ไม่จำเป็นหรือทำการค้นหา findViewById()
ที่มีราคาแพง ไลบรารีการสนับสนุนของ Android มีเครื่องมือจัดการเลย์เอาต์มาตรฐาน 3 รายการ ซึ่งแต่ละรายการมีตัวเลือกการปรับแต่งมากมาย ดังนี้
LinearLayoutManager
: จัดเรียงรายการในลิสต์มิติข้อมูลเดียว การใช้RecyclerView
กับLinearLayoutManager
จะให้ฟังก์ชันการทำงานเหมือนกับเลย์เอาต์ListView
GridLayoutManager
: จัดเรียงรายการในตาราง 2 มิติ เช่น สี่เหลี่ยมจัตุรัสบนกระดานหมากรุก การใช้RecyclerView
กับGridLayoutManager
จะให้ฟังก์ชันการทำงานเหมือนกับเลย์เอาต์GridView
StaggeredGridLayoutManager
: จัดเรียงรายการในตารางกริด 2 มิติ โดยแต่ละคอลัมน์จะเลื่อนออกไปจากคอลัมน์ก่อนหน้าเล็กน้อย เช่น ดาวบนธงชาติอเมริกัน
หากเครื่องมือจัดการเลย์เอาต์เหล่านี้ไม่เหมาะกับความต้องการของคุณ คุณก็สร้างเครื่องมือจัดการเองได้โดยการขยายRecyclerView.LayoutManager
คลาส抽象
เพิ่มภาพเคลื่อนไหวของสินค้า
ทุกครั้งที่มีการเปลี่ยนแปลงรายการ RecyclerView
จะใช้อนิเมเตอร์เพื่อเปลี่ยนลักษณะที่ปรากฏ อนิเมเตอร์นี้เป็นออบเจ็กต์ที่ขยายคลาส RecyclerView.ItemAnimator
แบบนามธรรม โดยค่าเริ่มต้น RecyclerView
จะใช้
DefaultItemAnimator
เพื่อแสดงภาพเคลื่อนไหว หากต้องการระบุภาพเคลื่อนไหวที่กําหนดเอง คุณสามารถกําหนดออบเจ็กต์ Animator ของคุณเองได้โดยขยายRecyclerView.ItemAnimator
เปิดใช้การเลือกรายการในลิสต์
ไลบรารี recyclerview-selection
ช่วยให้ผู้ใช้เลือกรายการในรายการ RecyclerView
ได้โดยใช้การป้อนข้อมูลด้วยการสัมผัสหรือเมาส์ ซึ่งจะช่วยให้คุณควบคุมการนำเสนอภาพของรายการที่เลือกได้ นอกจากนี้ คุณยังควบคุมนโยบายที่ควบคุมลักษณะการทํางานของการเลือกได้ด้วย เช่น รายการที่มีสิทธิ์เลือกและจํานวนรายการที่เลือกได้
หากต้องการเพิ่มการรองรับการเลือกลงในอินสแตนซ์ RecyclerView
ให้ทำตามขั้นตอนต่อไปนี้
- เลือกประเภทคีย์การเลือกที่จะใช้ แล้วสร้าง
ItemKeyProvider
คุณสามารถระบุรายการที่เลือกได้โดยใช้คีย์ 3 ประเภทต่อไปนี้
Parcelable
และคลาสย่อย เช่นUri
String
Long
ดูรายละเอียดเกี่ยวกับประเภทคีย์การเลือกได้ที่
SelectionTracker.Builder
- ใช้งาน
ItemDetailsLookup
- อัปเดตออบเจ็กต์
View
ในRecyclerView
เพื่อแสดงว่าผู้ใช้เลือกหรือยกเลิกการเลือกออบเจ็กต์หรือไม่คลังรายการที่เลือกไม่มีการตกแต่งภาพเริ่มต้นสำหรับรายการที่เลือก ระบุข้อมูลนี้เมื่อติดตั้งใช้งาน
onBindViewHolder()
เราขอแนะนําแนวทางต่อไปนี้- ใน
onBindViewHolder()
ให้เรียกใช้setActivated()
notsetSelected()
บนออบเจ็กต์View
ด้วยtrue
หรือfalse
โดยขึ้นอยู่กับว่ามีการเลือกรายการหรือไม่ - อัปเดตการจัดรูปแบบของมุมมองเพื่อแสดงสถานะที่เปิดใช้งาน เราขอแนะนำให้ใช้ทรัพยากรรายการสถานะสีเพื่อกำหนดค่าการจัดรูปแบบ
- ใน
- ใช้
ActionMode
เพื่อให้ผู้ใช้มีเครื่องมือในการดําเนินการกับสิ่งที่เลือก - ดำเนินการรองที่ตีความแล้ว
- รวบรวมทุกอย่างด้วย
SelectionTracker.Builder
- รวมการเลือกไว้ในเหตุการณ์วงจรของกิจกรรม
ItemDetailsLookup
อนุญาตให้ไลบรารีการเลือกเข้าถึงข้อมูลเกี่ยวกับ RecyclerView
รายการที่มี MotionEvent
อินสแตนซ์นี้เปรียบเสมือนโรงงานสำหรับItemDetails
ที่สำรองข้อมูลหรือดึงมาจากRecyclerView.ViewHolder
ลงทะเบียน SelectionTracker.SelectionObserver
เพื่อรับการแจ้งเตือนเมื่อมีการเปลี่ยนแปลงรายการที่เลือก เมื่อสร้างสิ่งที่เลือกเป็นครั้งแรก ให้เริ่ม ActionMode
เพื่อนำเสนอข้อมูลนี้ต่อผู้ใช้และระบุการดำเนินการเฉพาะการเลือก เช่น คุณสามารถเพิ่มปุ่มลบลงในแถบ ActionMode
และเชื่อมต่อลูกศรย้อนกลับในแถบเพื่อล้างการเลือก เมื่อไม่มีรายการที่เลือกแล้ว (หากผู้ใช้ล้างการเลือกครั้งล่าสุด) ให้สิ้นสุดโหมดการดำเนินการ
ที่ส่วนท้ายของไปป์ไลน์การประมวลผลเหตุการณ์ ไลบรารีอาจระบุว่าผู้ใช้พยายามเปิดใช้งานรายการ โดยแตะที่รายการนั้น หรือพยายามลากรายการหรือชุดของรายการที่เลือก ตอบสนองต่อคําอธิบายเหล่านี้โดยลงทะเบียนโปรแกรมฟังที่เหมาะสม ดูข้อมูลเพิ่มเติมได้ที่ SelectionTracker.Builder
ตัวอย่างต่อไปนี้แสดงวิธีรวมข้อมูลเหล่านี้เข้าด้วยกัน
Kotlin
var tracker = SelectionTracker.Builder( "my-selection-id", recyclerView, StableIdKeyProvider(recyclerView), MyDetailsLookup(recyclerView), StorageStrategy.createLongStorage()) .withOnItemActivatedListener(myItemActivatedListener) .build()
Java
SelectionTracker tracker = new SelectionTracker.Builder<>( "my-selection-id", recyclerView, new StableIdKeyProvider(recyclerView), new MyDetailsLookup(recyclerView), StorageStrategy.createLongStorage()) .withOnItemActivatedListener(myItemActivatedListener) .build();
หากต้องการสร้างอินสแตนซ์ SelectionTracker
แอปของคุณต้องระบุ RecyclerView.Adapter
เดียวกันกับที่ใช้เพื่อเริ่มต้นค่า RecyclerView
เป็น SelectionTracker.Builder
ด้วยเหตุนี้ หลังจากสร้างอินสแตนซ์ SelectionTracker
แล้ว ให้แทรกลงใน RecyclerView.Adapter
ไม่เช่นนั้น คุณจะตรวจสอบสถานะที่เลือกของรายการจากวิธีการ onBindViewHolder()
ไม่ได้
หากต้องการเก็บรักษาสถานะการเลือกในเหตุการณ์ตลอดวงจรชีวิตของกิจกรรม แอปของคุณต้องเรียกใช้เมธอด onSaveInstanceState()
และ
onRestoreInstanceState()
ของเครื่องมือติดตามการเลือกจากเมธอด onSaveInstanceState()
และ
onRestoreInstanceState()
ของกิจกรรมตามลำดับ นอกจากนี้ แอปของคุณยังต้องระบุรหัสการเลือกที่ไม่ซ้ำกันให้กับตัวสร้าง SelectionTracker.Builder
ด้วย คุณต้องใช้รหัสนี้เนื่องจากกิจกรรมหรือข้อมูลโค้ดอาจมีรายการที่เลือกได้ซึ่งแตกต่างกันมากกว่า 1 รายการ ซึ่งรายการทั้งหมดต้องคงอยู่ในสถานะที่บันทึกไว้
แหล่งข้อมูลเพิ่มเติม
ดูข้อมูลเพิ่มเติมจากแหล่งข้อมูลต่อไปนี้
- แอปสาธิต Sunflower ซึ่งใช้
RecyclerView
- Codelab ใช้ RecyclerView เพื่อแสดงรายการที่เลื่อนได้
- Android หลักพื้นฐานของ Kotlin: หลักพื้นฐานของ RecyclerView ใน Codelab