يتم تنفيذ نمط واجهة المستخدم من خلال التمرير السريع لإعادة التحميل بالكامل داخل التطبيق المصغَّر 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>