يمكن أن تساعد القوائم القابلة للتنقّل في إدارة مجموعات البيانات وإنشاء تصميمات سريعة الاستجابة وتسهيل التنقّل. يمكنك عرض مجموعات أصغر من العناصر في تطبيقك باستخدام قائمة محدودة يمكن التمرير فيها. لتجنُّب مشاكل الأداء في مجموعات البيانات الأكبر حجمًا أو في قائمة ذات طول غير معروف، اطّلِع على مقالة تحميل البيانات بشكلٍ بطيء باستخدام القوائم وميزة "التنقّل في البيانات".
توافق الإصدار
يتطلّب هذا التنفيذ ضبط الحد الأدنى من إصدار حزمة تطوير البرامج (SDK) لمشروعك على المستوى 21 من واجهة برمجة التطبيقات أو مستوى أعلى.
التبعيات
إنشاء قائمة لفلفة عمودية
استخدِم الرمز البرمجي التالي لإنشاء قائمة لفّ عمودي:
@Composable private fun ScrollBoxes() { Column( modifier = Modifier .background(Color.LightGray) .size(100.dp) .verticalScroll(rememberScrollState()) ) { repeat(10) { Text("Item $it", modifier = Modifier.padding(2.dp)) } } }
النقاط الرئيسية حول الرمز
- لضبط سلوك الانتقال للأعلى أو للأسفل في
Column
باستخدام المُعدِّلverticalScroll
والدالةrememberScrollState
. - لإنشاء قائمة بتمرير أفقي، أنشئ
Row
مع مُعدِّلhorizontalScroll
.
النتائج
![قائمة رأسية تستجيب للإيماءات المتعلّقة بالتمرير](https://developer.android.google.cn/static/develop/ui/compose/images/gestures-simplescroll.gif?hl=ar)
المجموعات التي تتضمّن هذا الدليل
هذا الدليل هو جزء من مجموعات الأدلة السريعة المنظَّمة التي تتناول أهداف تطوير Android الأوسع نطاقًا:
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=ar)
عرض قائمة أو شبكة
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=ar)
عرض المكونات التفاعلية
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=ar)