یک لیست صفحه بندی ایجاد کنید تا کاربران بتوانند برای دسترسی به محتوای بیش از حد بزرگ که روی یک صفحه نمایش قرار نگیرد، پیمایش کنند. فهرستهای صفحهبندی افقی میتوانند به کاربران کمک کنند تا در میان محتواهایی مانند تصاویر، نمایش اسلاید یا چرخ فلک محصول حرکت کنند. فهرستهای صفحهبندی عمودی برای برنامههای پرمحتوا مفید هستند، جایی که کاربران ممکن است نیاز به پیمایش در تعداد زیادی از موارد، مانند مقالهها داشته باشند.
سازگاری نسخه
این پیاده سازی مستلزم آن است که minSDK پروژه شما روی سطح API 21 یا بالاتر تنظیم شود.
وابستگی ها
یک لیست صفحه بندی ایجاد کنید
بسته به جهت مورد نیاز برای برنامه خود، می توانید یک لیست صفحه بندی افقی یا عمودی را پیکربندی کنید. کد زیر یک لیست صفحه بندی افقی ایجاد می کند که 10 مورد را نمایش می دهد:
نکات کلیدی در مورد کد
-
HorizontalPager
composable فهرستی از آیتمها را با قابلیت پیمایش افقی ارائه میکند.- برای ایجاد یک لیست صفحه بندی عمودی، به جای آن از
VerticalPager
composable استفاده کنید.
- برای ایجاد یک لیست صفحه بندی عمودی، به جای آن از
- هر صفحه در لیست حاوی یک شی
Text
است که رشته "Page" و شماره فهرست صفحه را نمایش می دهد. - نمونهای از
rememberPagerState()
وضعیت یک صفحه را زمانی که کاربر حرکت میکند باقی میماند و هنگامی که کاربر به آن باز میگردد همان صفحه را نمایش میدهد.
نتایج
HorizontalPager
. مجموعه هایی که حاوی این راهنما هستند
این راهنما بخشی از مجموعههای راهنمای Quick Guide است که اهداف توسعه Android گستردهتری را پوشش میدهد:
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=fa)
نمایش یک لیست یا شبکه
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=fa)
نمایش اجزای تعاملی
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=fa)