إضافة تمرير سريع لإعادة التحميل إلى تطبيقك

يتم تنفيذ نمط واجهة المستخدم بالتمرير السريع للتحديث بالكامل داخل SwipeRefreshLayout يرصد التمرير السريع عموديًا، ويعرض شريط تقدّم مميزًا، ويُطلق على ميزة معاودة الاتصال الطرق في تطبيقك. يمكنك تفعيل هذا السلوك بإضافة الأداة إلى ملف التنسيق كعنصر رئيسي ListView أو GridView وتنفيذ سلوك إعادة التحميل الذي يتم استدعاؤه عندما يمرر المستخدم سريعًا

توضّح هذه الصفحة كيفية إضافة الأداة إلى تنسيق حالي. وهي تعرض أيضًا كيفية إضافة تحديث إجراء إلى منطقة تجاوز شريط الإجراءات بحيث يمكن للمستخدمين الذين لا يمكنهم استخدام إيماءة التمرير السريع تشغيل التحديث اليدوي لجهاز خارجي.

إضافة تبعية FastRefreshLayout

لاستخدام SwipeRefreshLayout في تطبيقك، أضِف الاعتمادية التالية إلى ملف build.gradle:

Groovy

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

Kotlin

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

إضافة أداة ScrollRefreshLayout

لإضافة التطبيق المصغَّر لإعادة التحميل إلى تطبيق حالي، يمكنك إضافة 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.

إضافة إجراء إعادة التحميل إلى شريط الإجراءات

يمكنك إضافة إجراء إعادة تحميل إلى شريط الإجراءات في تطبيقك كي يتمكّن المستخدمون الذين لا يمكنهم تنفيذ إيماءات التمرير السريع من تشغيل تحديث يدوي. على سبيل المثال، يمكن للمستخدمين ذوي الاحتياجات الخاصة تسهيل الاستخدام تشغيل إجراءات شريط الإجراءات. باستخدام أجهزة خارجية، مثل لوحات المفاتيح ولوحات التحكّم.

إضافة إجراء التحديث كعنصر في القائمة، وليس كزر، من خلال ضبط السمة 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>