إزالة مؤشر Overscroll في Flutter محليًا عبر ScrollConfiguration، مع بقاء التمرير وفهم الفرق بين المؤثر البصري وScrollPhysics وتجنب الواجهات القديمة.
ما الذي تريد إزالته؟
قد يظهر عند نهاية قائمة تأثير توهج أو تمدد أو سلوك آخر حسب المنصة والثيم وإصدار Flutter. إخفاء المؤشر البصري ليس إيقاف التمرير نفسه، وليس إزالة المحتوى الزائد من القائمة. حدد المشكلة من لقطة أو تجربة فعلية: هل تريد إخفاء زينة الحافة أم تغيير الارتداد أم منع التمرير؟ المثال يطبق هدفًا واحدًا فقط، هو تعطيل زخرفة overscroll الافتراضية في نطاق قائمة محددة، ويبقي المستخدم قادرًا على الوصول إلى العناصر الأخيرة.
تغيير محلي واضح
ScrollConfiguration يسمح بتوفير ScrollBehavior لنطاق من الشجرة. نستعمل ScrollConfiguration.of(context).copyWith(overscroll: false) بدل استبدال سلوك التطبيق كله بصنف عام يفقد إعدادات أخرى. هذا يجعل الأثر محليًا للدروس المعروضة ويقلل المفاجآت في صفحات أخرى. لا تضع override في MaterialApp فقط لأن قائمة واحدة تحتاجه، ولا تنسخ سلوكًا خاصًا بهاتفك إلى كل منصات الويب وسطح المكتب دون مراجعة طريقة الإدخال والتمرير هناك.
Physics قضية مختلفة
ClampingScrollPhysics وBouncingScrollPhysics يغيران جوانب من حركة التمرير، بينما إخفاء المؤشر البصري لا يعني أنك اخترت physics جديدة. قد يبقى إحساس الحركة مختلفًا بين المنصات حتى مع غياب الزينة. لا تعد المستخدم أن سطر overscroll: false يوحد كل الإيماءات أو يحسن الأداء بنسبة محددة، ولا تستعمل NeverScrollableScrollPhysics إذا كان المطلوب فقط إخفاء التوهج؛ ذلك قد يمنع وصولًا مباشرًا للقائمة ويغير الهدف. اختر الحركة بناءً على تجربة المنتج لا على اسم خاصية متشابه.
بديل الإشعار وحدود الانتشار
يمكن في سياق مناسب التعامل مع OverscrollIndicatorNotification عبر disallowIndicator ثم إعادة bool مقصودًا، لكن نسخ disallowGlow القديمة مع return فارغ يسبب عدم توافق أو عقدًا غير صحيح. إذا كنت تراقب إشعارات فرعية فراجع depth ولا تمنع مؤثرات مكونات أخرى دون قصد. إرجاع true يوقف انتشار الإشعار إلى الأب، ولا ينبغي استخدامه كإعداد افتراضي لكل مستمع لمجرد أنه يجعل مثالًا قصيرًا يعمل. المثال الحالي يفضل السلوك المحلي لأنه يوضح النطاق دون مستمع إضافي.
لا تخلط Scrollbar بالمؤشر
شريط التمرير يعطي معلومة عن الموضع وقد يكون مهمًا خاصة في سطح المكتب أو محتوى طويل. تعطيل overscroll لا يطلب إخفاء scrollbar، لذلك لا نضيف scrollbars: false بلا متطلب. راجع اتجاه القائمة وتكبير النص والوصول بالكيبورد والفأرة، وتأكد أن التغييرات البصرية لا تحذف العلامة الوحيدة التي يعتمد عليها المستخدم لمعرفة وجود محتوى آخر. إذا احتجت أسلوبًا مختلفًا لشريط التمرير فصممه كقرار مستقل مع التباين والظهور والتفاعل المناسبين.
كيف تتحقق؟
مرر حتى نهاية القائمة وواصل السحب لتراجع المؤثر على المنصة المستهدفة، ثم ارجع إلى البداية. افحص بنية الاختبار للتأكد من عدم وجود مؤشرات افتراضية داخل النطاق ومن استمرار تغير الموضع بعد السحب. هذا لا يثبت شكل كل إصدار Android أو iOS أو كل theme مخصص؛ اختبار الجهاز الفعلي يبقى مطلوبًا إذا كان الاختلاف البصري سبب الطلب. المثال بلا شبكة ولا حزم خارجية، ويمكن دمجه محليًا بعد مراجعة أي ScrollBehavior خاص موجود أصلًا في المشروع حتى لا تمحو قرارًا مقصودًا.
مثال مستقل للتجربة
شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.
import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class DemoPage extends StatelessWidget {
const DemoPage({super.key});
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(title: const Text('No overscroll indicator')),
body: ScrollConfiguration(
behavior: ScrollConfiguration.of(context).copyWith(overscroll: false),
child: ListView.separated(
key: const ValueKey('plain-scroll-list'), padding: const EdgeInsets.all(16), itemCount: 50,
separatorBuilder: (_, _) => const Divider(),
itemBuilder: (_, index) => ListTile(
leading: const Icon(Icons.menu_book),
title: Text('Lesson ${index + 1}'),
subtitle: const Text('Scrolling remains available; only the indicator is disabled here.'),
),
),
),
);
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.







