فهرستهای قابل پیمایش میتوانند به مدیریت مجموعه دادهها، ایجاد طرحهای واکنشگرا و تسهیل ناوبری کمک کنند. میتوانید مجموعههای کوچکتری از آیتمها را در برنامه خود با استفاده از فهرست پیمایش محدود نمایش دهید. برای جلوگیری از مشکلات عملکرد با مجموعه دادههای بزرگتر یا فهرستی با طول ناشناخته، به بارگذاری تنبل داده با فهرستها و صفحهبندی مراجعه کنید.
سازگاری نسخه
این پیاده سازی مستلزم آن است که minSDK پروژه شما روی سطح API 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.com/static/develop/ui/compose/images/gestures-simplescroll.gif?hl=fa)
مجموعه هایی که حاوی این راهنما هستند
این راهنما بخشی از مجموعههای راهنمای Quick Guide است که اهداف توسعه Android گستردهتری را پوشش میدهد:
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=fa)
نمایش یک لیست یا شبکه
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=fa)
نمایش اجزای تعاملی
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=fa)