طرح‌بندی تازه را بکشید

الگوی رابط کاربری با کشیدن انگشت برای تازه کردن صفحه (swipe-to-refresh) را پیاده‌سازی کنید.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۱۹ نوامبر ۲۰۲۵ ۱.۱.۰ ۱.۲.۰-rc01 - -

اعلام وابستگی‌ها

برای افزودن یک وابستگی به SwipeRefreshLayout، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's Maven را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار

dependencies {
    implementation "androidx.swiperefreshlayout:swiperefreshlayout:1.1.0"
}

کاتلین

dependencies {
    implementation("androidx.swiperefreshlayout:swiperefreshlayout:1.1.0")
}

برای اطلاعات بیشتر در مورد وابستگی‌ها، به «افزودن وابستگی‌های ساخت» مراجعه کنید.

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۲.۰

نسخه ۱.۲.۰-rc01

۱۹ نوامبر ۲۰۲۵

androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-rc01 منتشر شد. نسخه 1.2.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۲.۰-بتا۰۱

۱۲ فوریه ۲۰۲۵

androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-beta01 منتشر شد. نسخه 1.2.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • قابلیت تهی بودن مشخص شده برای پارامترهای متد SwipeRefreshLayout و انواع بازگشتی ( I006d1 ، b/236497776 )

رفع اشکالات

  • این کتابخانه اکنون از حاشیه‌نویسی‌های nullness از نوع JSpecify استفاده می‌کند که از نوع type-use هستند. توسعه‌دهندگان کاتلین باید از آرگومان کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict (این پیش‌فرض است که از نسخه 2.1.0 کامپایلر کاتلین شروع می‌شود). ( Iaf490 ، b/326456246 )

نسخه ۱.۲.۰-آلفا۰۱

۲۲ ژوئیه ۲۰۲۰

androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-alpha01 منتشر شد. نسخه 1.2.0-alpha01 شامل این کامیت‌ها است.

رفع اشکالات

  • requestDisallowInterceptTouchEvent(boolean) اکنون مانند هر ViewGroup دیگری درخواست را می‌پذیرد. اگرچه اکیداً توصیه نمی‌شود، اما می‌توان رفتار جدید را با setLegacyRequestDisallowInterceptTouchEventEnabled غیرفعال کرد. ( I968da , b/141855018 )

نسخه ۱.۱.۰

نسخه ۱.۱.۰

۲۴ ژوئن ۲۰۲۰

androidx.swiperefreshlayout:swiperefreshlayout:1.1.0 منتشر شد. نسخه ۱.۱.۰ شامل این کامیت‌ها است.

تغییرات عمده از زمان ۱.۰.۰

  • SwipeRefreshLayout اکنون NestedScrollingChild3 و NestedScrollingParent3 را پیاده‌سازی می‌کند.

نسخه ۱.۱.۰-rc01

۱۵ آوریل ۲۰۲۰

androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-rc01 بدون هیچ تغییری از زمان انتشار 1.1.0-beta01 منتشر شده است. نسخه ۱.۱.۰-rc01 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-بتا۰۱

۴ مارس ۲۰۲۰

androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-beta01 بدون هیچ تغییری از زمان 1.1.0-alpha03 منتشر شده است. نسخه 1.1.0-beta01 شامل این کامیت‌ها است.

نسخه ۱.۱.۰-آلفا۰۳

۹ اکتبر ۲۰۱۹

androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-alpha03 منتشر شد. نسخه 1.1.0-alpha03 شامل این کامیت‌ها است .

ویژگی‌های جدید

  • ما یک ویژگی سبک جدید R.styleable.SwipeRefreshLayout_swipeRefreshLayoutProgressSpinnerBackgroundColor داریم که برای تنظیم رنگ پس‌زمینه نشانگر پیشرفت استفاده می‌شود ( aosp/931124 ).

تغییرات API

  • requestDisallowInterceptTouchEvent(boolean) اکنون همیشه به سمت والدین خود منتشر می‌شود. اگرچه اکیداً توصیه نمی‌شود، اما می‌توان رفتار جدید را با setLegacyRequestDisallowInterceptTouchEventEnabled غیرفعال کرد. ( aosp/1108540 )

رفع اشکالات

  • مشکل پیمایش تو در تو که در آن SwipeRefreshLayout یک والد قابل پیمایش (مثلاً ViewPager2 ) و یک فرزند قابل پیمایش داشت، برطرف شد. ( b/138314213 )

نسخه ۱.۱.۰-آلفا۰۲

۲ ژوئیه ۲۰۱۹

androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-alpha02 منتشر شد. کامیت‌های موجود در این نسخه را می‌توانید اینجا پیدا کنید.

رفع اشکالات

  • ذخیره و بازیابی حالت رفرش SwipeRefreshLayout پیاده‌سازی شد.
  • اشکال قابلیت استفاده برطرف شد وقتی SwipeRefreshLayout در RecyclerView تعبیه شده بود

نسخه ۱.۱.۰-آلفا۰۱

۳ دسامبر ۲۰۱۸

تغییرات API

  • aosp/737631 : SwipeRefreshLayout اکنون NestedScrollingChild3 و NestedScrollingParent3 را پیاده‌سازی می‌کند و به ۳ والد و فرزند اجازه می‌دهد تا اطلاعات فاصله پیمایش تو در تو را از طریق SwipeRefreshLayout منتقل کنند. اگر کد توسعه‌دهنده در حال حاضر SwipeRefreshLayout.onNestedScroll(View, int, int, int, int, int) را لغو می‌کند، احتمالاً دیگر فراخوانی نخواهد شد و به جای آن SwipeRefreshLayout.onNestedScroll(View, int, int, int, int, int, int[]) باید لغو شود. به همین ترتیب، احتمالاً دیگر SwipeRefreshLayout.dispatchNestedScroll(int, int, int, int, int[], int) فراخوانی نخواهد شد و در عوض SwipeRefreshLayout.dispatchNestedScroll(int, int, int, int, int[], int, int[]) باید بازنویسی شود.