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

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

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

إضافة تبعية للتمرير السريع

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

رائع

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

Kotlin

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

إضافة التطبيق المصغَّر لإعادة تحميل التمرير

لإضافة التطبيق المصغّر لميزة التمرير سريعًا لإعادة التحميل إلى تطبيق حالي، أضِف 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>