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