เอกสารนี้ต่อยอดมาจากภาพรวมของไลบรารี Paging โดยอธิบายวิธีแสดงรายการข้อมูลแก่ผู้ใช้ใน UI ของแอป โดยเฉพาะเมื่อข้อมูลนี้มีการเปลี่ยนแปลง
เชื่อมต่อ UI กับโมเดลข้อมูลพร็อพเพอร์ตี้
คุณสามารถเชื่อมต่ออินสแตนซ์ของ LiveData<PagedList> กับ PagedListAdapter ได้ ดังที่แสดงในข้อมูลโค้ดต่อไปนี้
Kotlin
class ConcertActivity : AppCompatActivity() {
private val adapter = ConcertAdapter()
// Use the 'by viewModels()' Kotlin property delegate
// from the activity-ktx artifact
private val viewModel: ConcertViewModel by viewModels()
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState);
viewModel.concerts.observe(this, Observer { adapter.submitList(it) })
}
}
Java
public class ConcertActivity extends AppCompatActivity {
private ConcertAdapter adapter = new ConcertAdapter();
private ConcertViewModel viewModel;
@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
viewModel = new ViewModelProvider(this).get(ConcertViewModel.class);
viewModel.concertList.observe(this, adapter::submitList);
}
}
เมื่อแหล่งข้อมูลระบุอินสแตนซ์ใหม่ของ PagedList กิจกรรมจะส่งออบเจ็กต์เหล่านี้ไปยังอะแดปเตอร์ การติดตั้งใช้งาน PagedListAdapter จะกำหนดวิธีคำนวณการอัปเดต และจะจัดการการแบ่งหน้าและการเปรียบเทียบรายการโดยอัตโนมัติ
ดังนั้น ViewHolder ของคุณจึงต้องเชื่อมโยงกับรายการที่ระบุไว้รายการเดียวเท่านั้น ดังนี้
Kotlin
class ConcertAdapter() :
PagedListAdapter<Concert, ConcertViewHolder>(DIFF_CALLBACK) {
override fun onBindViewHolder(holder: ConcertViewHolder, position: Int) {
val concert: Concert? = getItem(position)
// Note that "concert" is a placeholder if it's null.
holder.bindTo(concert)
}
companion object {
private val DIFF_CALLBACK = ... // See Implement the diffing callback section.
}
}
Java
public class ConcertAdapter
extends PagedListAdapter<Concert, ConcertViewHolder> {
protected ConcertAdapter() {
super(DIFF_CALLBACK);
}
@Override
public void onBindViewHolder(@NonNull ConcertViewHolder holder,
int position) {
Concert concert = getItem(position);
// Note that "concert" can be null if it's a placeholder.
holder.bindTo(concert);
}
private static DiffUtil.ItemCallback<Concert> DIFF_CALLBACK
= ... // See Implement the diffing callback section.
}
PagedListAdapter จะจัดการเหตุการณ์การโหลดหน้าเว็บโดยใช้ออบเจ็กต์ PagedList.Callback เมื่อผู้ใช้เลื่อน PagedListAdapter จะเรียก PagedList.loadAround() เพื่อให้คำแนะนำแก่ PagedList ที่เกี่ยวข้องเกี่ยวกับรายการที่ควรดึงข้อมูลจาก DataSource
ใช้ Callback การเปรียบเทียบความแตกต่าง
ตัวอย่างต่อไปนี้แสดงการติดตั้งใช้งาน areContentsTheSame() ด้วยตนเอง ซึ่งจะเปรียบเทียบฟิลด์ออบเจ็กต์ที่เกี่ยวข้อง
Kotlin
private val DIFF_CALLBACK = object : DiffUtil.ItemCallback<Concert>() {
// The ID property identifies when items are the same.
override fun areItemsTheSame(oldItem: Concert, newItem: Concert) =
oldItem.id == newItem.id
// If you use the "==" operator, make sure that the object implements
// .equals(). Alternatively, write custom data comparison logic here.
override fun areContentsTheSame(
oldItem: Concert, newItem: Concert) = oldItem == newItem
}
Java
private static DiffUtil.ItemCallback<Concert> DIFF_CALLBACK =
new DiffUtil.ItemCallback<Concert>() {
@Override
public boolean areItemsTheSame(Concert oldItem, Concert newItem) {
// The ID property identifies when items are the same.
return oldItem.getId() == newItem.getId();
}
@Override
public boolean areContentsTheSame(Concert oldItem, Concert newItem) {
// Don't use the "==" operator here. Either implement and use .equals(),
// or write custom data comparison logic here.
return oldItem.equals(newItem);
}
};
เนื่องจากอะแดปเตอร์มีคำจำกัดความของการเปรียบเทียบรายการ อะแดปเตอร์จึงตรวจหาการเปลี่ยนแปลงของรายการเหล่านี้โดยอัตโนมัติเมื่อโหลดออบเจ็กต์ PagedList ใหม่ ด้วยเหตุนี้ อะแดปเตอร์จึงทริกเกอร์ภาพเคลื่อนไหวของรายการที่มีประสิทธิภาพภายในออบเจ็กต์ RecyclerView
การเปรียบเทียบโดยใช้อะแดปเตอร์ประเภทอื่น
หากเลือกที่จะไม่รับค่าจาก PagedListAdapter เช่น เมื่อคุณใช้ไลบรารีที่มีอะแดปเตอร์ของตัวเอง คุณยังคงใช้ฟังก์ชันการเปรียบเทียบของอะแดปเตอร์ไลบรารี Paging ได้โดยทำงานกับออบเจ็กต์ AsyncPagedListDiffer โดยตรง
ระบุตัวยึดตำแหน่งใน UI
ในกรณีที่คุณต้องการให้ UI แสดงรายการก่อนที่แอปจะดึงข้อมูลเสร็จ คุณสามารถแสดงรายการตัวยึดตำแหน่งให้ผู้ใช้เห็นได้ PagedList จะจัดการกรณีนี้โดยแสดงข้อมูลสินค้าเป็น null จนกว่าจะโหลดข้อมูล
ตัวยึดตำแหน่งมีประโยชน์ดังนี้
- การรองรับแถบเลื่อน:
PagedListจะระบุจำนวนรายการในลิสต์ให้กับPagedListAdapterข้อมูลนี้ช่วยให้อะแดปเตอร์วาดแถบเลื่อนที่แสดงขนาดทั้งหมดของรายการได้ เมื่อโหลดหน้าใหม่ แถบเลื่อนจะไม่กระโดดเนื่องจากรายการของคุณไม่เปลี่ยนขนาด - ไม่จำเป็นต้องมีไอคอนหมุนแสดงการโหลด: เนื่องจากทราบขนาดรายการอยู่แล้ว จึงไม่จำเป็นต้องแจ้งเตือนผู้ใช้ว่ากำลังโหลดรายการเพิ่มเติม ตัวยึดตำแหน่งจะสื่อข้อมูลนั้นเอง
อย่างไรก็ตาม ก่อนที่จะเพิ่มการรองรับตัวยึดตำแหน่ง โปรดคำนึงถึงเงื่อนไขเบื้องต้นต่อไปนี้
- ต้องใช้ชุดข้อมูลที่นับได้: อินสแตนซ์ของ
DataSourceจากไลบรารี Room Persistence สามารถนับรายการได้อย่างมีประสิทธิภาพ อย่างไรก็ตาม หากคุณใช้โซลูชันพื้นที่เก็บข้อมูลในเครื่องที่กำหนดเองหรือสถาปัตยกรรมข้อมูลแบบเครือข่ายเท่านั้น การระบุจำนวนรายการที่ประกอบขึ้นเป็นชุดข้อมูลอาจมีค่าใช้จ่ายสูงหรือเป็นไปไม่ได้เลย - ต้องใช้อะแดปเตอร์เพื่อพิจารณารายการที่ไม่ได้โหลด: อะแดปเตอร์หรือกลไกการนำเสนอที่คุณใช้เพื่อเตรียมรายการสำหรับการขยายต้องจัดการรายการที่เป็นค่า Null เช่น เมื่อเชื่อมโยงข้อมูลกับ
ViewHolderคุณต้องระบุค่าเริ่มต้นเพื่อแสดงข้อมูลที่ไม่ได้โหลด - ต้องใช้มุมมองรายการที่มีขนาดเท่ากัน: หากขนาดของรายการในลิสต์เปลี่ยนแปลงได้ตามเนื้อหา เช่น การอัปเดตเครือข่ายโซเชียล การเฟดข้ามระหว่างรายการจะดูไม่ดีนัก เราขอแนะนำอย่างยิ่งให้ปิดใช้ตัวยึดตำแหน่งในกรณีนี้
แสดงความคิดเห็น
แชร์ความคิดเห็นและไอเดียของคุณกับเราผ่านแหล่งข้อมูลต่อไปนี้
- Issue Tracker

- รายงานปัญหาเพื่อให้เราแก้ไขข้อบกพร่องได้
แหล่งข้อมูลเพิ่มเติม
ดูข้อมูลเพิ่มเติมเกี่ยวกับไลบรารี Paging ได้จากแหล่งข้อมูลต่อไปนี้
ตัวอย่าง
Codelab
วิดีโอ
- Android Jetpack: manage infinite lists with RecyclerView and Paging (Google I/O '18)
- Android Jetpack: เพจจิ้ง
แนะนำสำหรับคุณ
- หมายเหตุ: ข้อความลิงก์จะแสดงเมื่อ JavaScript ปิดอยู่
- ภาพรวมไลบรารี Paging 2
- ย้ายข้อมูลไปยัง Paging 3
- รวบรวมข้อมูลที่มีการแบ่งหน้า