แสดงรายการแบบแบ่งหน้า

เอกสารนี้ต่อยอดมาจากภาพรวมของไลบรารี 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

วิดีโอ