Swiperefreshlayout

הטמעה של תבנית ממשק המשתמש 'החלקה לרענון'.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫3 בדצמבר 2025 ‫1.2.0 - - -

הצהרה על יחסי תלות

כדי להוסיף תלות ב-SwipeRefreshLayout, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.

אתם יכולים להוסיף את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle של האפליקציה או המודול:

מגניב

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

Kotlin

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

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.2.0

גרסה 1.2.0

‫3 בדצמבר 2025

‫androidx.swiperefreshlayout:swiperefreshlayout:1.2.0 מופץ. גרסה 1.2.0 מכילה את השמירות האלה.

שינויים חשובים מאז גרסה 1.1.0:

תיקוני באגים

  • אם סמל הרענון כבר נסגר, פשוט מסירים את החץ לגמרי כדי שהצל שלו לא יוצג. (5350ff, b/186557635)
  • אחרי שהסמל נסוג, הוא צריך לאפס את המיקום ואת כל המאפיינים שלו, כדי שיוצג במצב הנכון כשהוא יופיע שוב. בעבר, חץ ההתקדמות הוסתר, אבל שאר המצב לא אופס. (766241, ‏ b/190379246)
  • ‫requestDisallowInterceptTouchEvent(boolean) יכבד עכשיו את הבקשה כמו כל ViewGroup אחר. אפשר להשבית את ההתנהגות החדשה באמצעות setLegacyRequestDisallowInterceptTouchEventEnabled, אבל אנחנו לא ממליצים לעשות את זה. (I968da, b/141855018)

גרסה ‎1.2.0-rc01

‫19 בנובמבר 2025

‫androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-rc01 מופץ. גרסה ‎1.2.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.2.0-beta01

‫12 בפברואר 2025

‫androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-beta01 מופץ. גרסה ‎1.2.0-beta01 מכילה את השמירות האלה.

שינויים ב-API

  • צוינה אפשרות ה-null של פרמטרים של שיטת SwipeRefreshLayout וסוגי החזרה (I006d1, ‏ b/236497776)

תיקוני באגים

  • הספרייה הזו משתמשת עכשיו באנוטציות של JSpecify nullness, שהן מסוג type-use. מפתחים ב-Kotlin צריכים להשתמש בארגומנט המהדר הבא כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict (זו ברירת המחדל החל מגרסה 2.1.0 של המהדר ב-Kotlin). (Iaf490, ‏ b/326456246)

גרסה ‎1.2.0-alpha01

22 ביולי 2020

‫androidx.swiperefreshlayout:swiperefreshlayout:1.2.0-alpha01 מופץ. גרסה ‎1.2.0-alpha01 מכילה את השמירות האלה.

תיקוני באגים

  • ‫requestDisallowInterceptTouchEvent(boolean) פועל עכשיו לפי הבקשה כמו כל ViewGroup אחר. למרות שלא מומלץ לעשות זאת, אפשר להשבית את ההתנהגות החדשה באמצעות setLegacyRequestDisallowInterceptTouchEventEnabled. (I968da, b/141855018)

גרסה 1.1.0

גרסה 1.1.0

‫24 ביוני 2020

‫androidx.swiperefreshlayout:swiperefreshlayout:1.1.0 מופץ. גרסה 1.1.0 מכילה את השמירות האלה.

שינויים משמעותיים מאז גרסה 1.0.0

  • ‫SwipeRefreshLayout מטמיע עכשיו את NestedScrollingChild3 ואת NestedScrollingParent3.

גרסה ‎1.1.0-rc01

15 באפריל 2020

הגרסה androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-rc01 פורסמה ללא שינויים מאז 1.1.0-beta01. גרסה ‎1.1.0-rc01 מכילה את השמירות האלה.

גרסה ‎1.1.0-beta01

4 במרץ 2020

הגרסה androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-beta01 פורסמה ללא שינויים מאז 1.1.0-alpha03. גרסה ‎1.1.0-beta01 מכילה את השמירות האלה.

גרסה ‎1.1.0-alpha03

‫9 באוקטובר 2019

‫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)

גרסה ‎1.1.0-alpha02

‫2 ביולי 2019

‫androidx.swiperefreshlayout:swiperefreshlayout:1.1.0-alpha02 מופץ. כאן אפשר לראות את השמירות שכלולות בגרסה הזו.

תיקוני באגים

  • הטמענו שמירה ושחזור של מצב הרענון של SwipeRefreshLayout
  • תוקן באג שקשור לנוחות השימוש כש-SwipeRefreshLayout מוטמע ב-RecyclerView

גרסה ‎1.1.0-alpha01

‫3 בדצמבר 2018

שינויים ב-API

  • ‫aosp/737631: SwipeRefreshLayout כולל עכשיו הטמעה של NestedScrollingChild3 ושל NestedScrollingParent3, שמאפשרת להורים ולילדים של 3 רכיבים של גלילה מקוננת להעביר מידע על מרחק הגלילה המקוננת שנצרך דרך 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[]).