הוספת אפשרות של החלקה לרענון לאפליקציה

דפוס ממשק המשתמש של 'החלקה לרענון' מיושם לגמרי בתוך SwipeRefreshLayout הווידג'ט, שמזהה את ההחלקה האנכית, מציג סרגל התקדמות ייחודי ומפעיל קריאה חוזרת (callback) שיטות באפליקציה שלכם. כדי להפעיל את ההתנהגות הזו, צריך להוסיף את הווידג'ט לקובץ הפריסה כהורה של ListView או GridView ויישום של המדיניות התנהגות של רענון שמופעלת כשהמשתמש מחליק במסך.

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

הוספת תלות ב-sהחלקה שנשמרו על פריסות

כדי להשתמש ב-SwipeRefreshLayout באפליקציה, צריך להוסיף את התלות הבאה אל קובץ build.gradle:

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

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

איך מוסיפים את הווידג'ט 'smokrecoveryLayout'

כדי להוסיף לאפליקציה קיימת את הווידג'ט להחלקה לרענון, צריך להוסיף את SwipeRefreshLayout בתור של ListView או GridView בודדים. SwipeRefreshLayout תומך רק ב-ListView או ב- חשבון צאצא אחד (GridView).

הדוגמה הבאה ממחישה איך להוסיף את הווידג'ט SwipeRefreshLayout קובץ פריסה קיים שמכיל ListView:

<androidx.swiperefreshlayout.widget.SwipeRefreshLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/swiperefresh"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <ListView
        android:id="@android:id/list"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</androidx.swiperefreshlayout.widget.SwipeRefreshLayout>

אפשר גם להשתמש בווידג'ט SwipeRefreshLayout ListFragment. אם הפריסה כוללת ListView עם המזהה "@android:id/list", פונקציונליות החלקה לרענון נתמכת באופן אוטומטי. עם זאת, הצהרה מפורשת הפונקציה ListView מחליפה את מבנה התצוגה שמוגדר כברירת מחדל ListFragment. אם המיקום ברצונך להשתמש במבנה ברירת המחדל של התצוגה, לעקוף חלקים של SwipeRefreshLayout ו-ListFragment.

הוספת פעולת רענון לסרגל הפעולות

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

מגדירים את המאפיין כדי להוסיף את פעולת הרענון כאפשרות בתפריט, ולא כלחצן. android:showAsAction=never אם אתם מציגים את הפעולה כלחצן, המשתמשים עשויים להניח פעולת הלחצן 'רענון' שונה מפעולת ההחלקה לרענון. ביצוע פעולת הרענון מקום בולט פחות בסרגל הפעולות מעודד את המשתמשים לבצע עדכונים ידניים באמצעות תנועות החלקה תוך שמירה על אפשרות נגישה שבה משתמשים בלחצני החיצים מחפשים.

הקוד הבא מדגים איך להוסיף את פעולת ההחלקה לרענון לאזור האפשרויות הנוספות:

<menu xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:id="@+id/menu_refresh"
        android:showAsAction="never"
        android:title="@string/menu_refresh"/>
</menu>