تستند هذه المقالة إلى نظرة عامة على مكتبة Paging، وتوضّح كيفية عرض قوائم المعلومات للمستخدمين في واجهة مستخدم تطبيقك، خاصةً عندما تتغيّر هذه المعلومات.
ربط واجهة المستخدم بنموذج العرض
يمكنك ربط مثيل 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.
تنفيذ دالة الاستدعاء الخاصة بالمقارنة
يوضّح النموذج التالي تنفيذًا يدويًا لـ 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، مثلاً عند استخدام مكتبة توفّر المحوّل الخاص بها، سيظل بإمكانك استخدام وظيفة المقارنة في محوّل "مكتبة التقسيم على صفحات" من خلال العمل مباشرةً مع عنصر AsyncPagedListDiffer.
توفير عناصر نائبة في واجهة المستخدم
في الحالات التي تريد فيها أن تعرض واجهة المستخدم قائمة قبل أن ينتهي تطبيقك من
جلب البيانات، يمكنك عرض عناصر قائمة العناصر النائبة للمستخدمين. يعالج PagedList هذه الحالة من خلال عرض بيانات المنتج على شكل null إلى أن يتم تحميل البيانات.
توفّر العناصر النائبة المزايا التالية:
- إتاحة استخدام أشرطة التمرير: يوفّر
PagedListعدد عناصر القائمة لـPagedListAdapter. تتيح هذه المعلومات للمحوّل رسم شريط تمرير يعرض الحجم الكامل للقائمة. ومع تحميل الصفحات الجديدة، لا يقفز شريط التمرير لأنّ حجم القائمة لا يتغيّر. - لا حاجة إلى مؤشر تحميل: بما أنّ حجم القائمة معروف مسبقًا، ليس من الضروري تنبيه المستخدمين إلى أنّه يتم تحميل المزيد من العناصر. تنقل العناصر النائبة نفسها هذه المعلومات.
قبل إضافة إمكانية استخدام العناصر النائبة، يجب مراعاة الشروط المسبقة التالية:
- يتطلّب مجموعة بيانات قابلة للعدّ: يمكن لمثيلات
DataSourceمن مكتبة Room لاستدامة البيانات عدّ عناصرها بكفاءة. إذا كنت تستخدم حلّ تخزين محلي مخصّص أو بنية بيانات مخصّصة للشبكة فقط، قد يكون من الصعب أو حتى من المستحيل تحديد عدد العناصر التي تتألف منها مجموعة البيانات. - يتطلب المحوّل حساب العناصر التي لم يتم تحميلها: يجب أن يتعامل المحوّل أو آلية العرض التي تستخدمها لإعداد القائمة للتضخم مع عناصر القائمة الفارغة. على سبيل المثال، عند ربط البيانات بـ
ViewHolder، عليك تقديم قيم تلقائية لتمثيل البيانات التي لم يتم تحميلها. - يتطلّب عرض عناصر بالحجم نفسه: إذا كان من الممكن تغيير أحجام عناصر القائمة بناءً على محتواها، مثل تحديثات الشبكات الاجتماعية، لن يبدو التلاشي التدريجي بين العناصر جيدًا. ننصح بشدة بإيقاف العناصر النائبة في هذه الحالة.
تقديم ملاحظات
يمكنك مشاركة ملاحظاتك وأفكارك معنا من خلال المراجع التالية:
- Issue Tracker

- يمكنك الإبلاغ عن المشاكل لنتمكّن من إصلاح الأخطاء.
مراجع إضافية
لمزيد من المعلومات حول مكتبة Paging، يُرجى الاطّلاع على المراجع التالية.
نماذج
اختبارات الرموز
الفيديوهات
- Android Jetpack: إدارة القوائم اللانهائية باستخدام RecyclerView وPaging (مؤتمر Google I/O لعام 2018)
- Android Jetpack: الانتقال من صفحة إلى أخرى
التطبيقات المقترَحة لك
- ملاحظة: يتم عرض نص الرابط عندما يكون JavaScript غير مفعَّل
- نظرة عامة على مكتبة Paging 2
- Migrate to Paging 3
- جمع البيانات المقسّمة على صفحات