الانتقال لبداية ونهاية ListView باستخدام animateTo في Flutter، مع التحقق من attachment ومراقبة الحدود وتوضيح الفرق بين اتجاه التمرير وحالته وموضعه.
ثلاثة أسئلة مختلفة
معرفة هل توجد حركة الآن تختلف عن معرفة اتجاه المستخدم وعن معرفة قربه من حدود القائمة. isScrollingNotifier يصف نشاط التمرير، ولا يكفي وحده لتحديد أين يقف المستخدم في كل لحظة. UserScrollNotification واتجاهه يرتبطان بسياق المحور وreverse، فلا تسمِّ كل reverse نزولًا في كل قائمة. المثال هنا يتعمد اختيار مهمة محددة: زران للبداية والنهاية ونص يصف الموضع بالنسبة للحدود، دون الادعاء أنه يراقب جميع الإيماءات أو يحلل نية المستخدم.
عمر controller واتصاله
أنشئ ScrollController مرة في State وأنهِه في dispose. لا تقرأ controller.position داخل initState قبل أن ترتبط القائمة به، ولا تفترض أن post frame واحدًا يضمن وجودها إذا كانت مشروطة أو لم تُعرض بعد. قبل الانتقال افحص hasClients ثم توفر أبعاد المحتوى. المثال يربط controller بقائمة واحدة فقط، لأن قراءة position تفترض موضعًا واحدًا. إذا كان عندك عدة قوائم فحدد المتحكم المقصود بدل مشاركة مثيل واحد وتوقع أن ينتقي النشطة تلقائيًا.
حدود القائمة ليست أرقامًا ثابتة
استخدم minScrollExtent وmaxScrollExtent بدل افتراض أن البداية دائمًا رقم تختاره من خارج التخطيط. عند المقارنة استخدم سماحية صغيرة بدل مساواة عائمة صارمة، خصوصًا مع القفز والحركة والارتداد. حدود قائمة قصيرة قد تتطابق فلا توجد مسافة تمرير، وعندها يذكر المثال أن المحتوى مناسب للمساحة. نحدّث الوصف فقط عند تغير حالة الحد، لا نعرض رقم pixels عبر setState لكل تغير إذا لم يكن المستخدم يحتاج تلك الدقة.
animateTo يمكن أن ينقطع
استدعاء animateTo يحرك إلى قيمة حالية خلال مدة غير صفرية، ويمكن أن يقطعه سحب المستخدم أو نشاط آخر. اكتمال Future لا يثبت وحده أن العنصر المطلوب أصبح مرئيًا إذا تغير المحتوى أو انتهت الحركة مبكرًا. في قائمة كسولة بعناصر متفاوتة قد يكون maxScrollExtent تقديرًا ويتغير أثناء البناء؛ لهذا نستخدم itemExtent ثابتًا في المثال. لإظهار عنصر مبني محدد يمكن تقييم ensureVisible، وللعناصر غير المبنية تحتاج آلية وصول مناسبة لهوية العنصر لا مجرد تخمين بكسلات.
القيود والإشعارات
إذا وضعت رأسًا فوق القائمة داخل Column فضع Expanded في موضعه البنيوي الصحيح، ولا تضعه داخل غلاف RenderObject غير مناسب ثم تتوقع أن يعمل ParentData. المثال يستخدم قائمة داخل Expanded مباشرة. عند استعمال NotificationListener في مشروعك رشح depth والمحور المطلوب وأعد bool واضحًا، فإرجاع true يوقف انتشار الإشعار إلى مستمعين أعلى. لا تستهلك كل الإشعارات إذا كان مكوّن أب مثل Scrollbar يحتاجها، ولا تنفذ تغيير تخطيط عشوائيًا من إشعار يأتي بعد مرحلة التخطيط.
الفحص قبل الدمج
اضغط End ثم Start وتأكد من تغير الموضع والوصف، ثم قاطع الحركة بالسحب وراجع بقاء التطبيق مستقرًا. اختبر قائمة قصيرة وعرضًا أفقيًا وخطًا كبيرًا وإزالة الصفحة أثناء الحركة. المثال لا ينفذ تحميل صفحات جديدة عند الوصول للنهاية؛ هذا يحتاج سياسة pagination مستقلة تمنع الطلب المتكرر وتتعامل مع الفشل. زر البداية والنهاية يجب أن يحمل تسمية واضحة للكيبورد وقارئ الشاشة، ولا تستخدم أيقونة تتبدل بلا tooltip يجعل مقصدها مجهولًا. قياس سلاسة التمرير على جهازك يبقى منفصلًا عن صحة تدفق المثال.
مثال مستقل للتجربة
شغّل المثال داخل مشروع Flutter تجريبي. يعتمد على Material فقط ولا يحتاج assets أو أصنافًا من مشروع خاص. غيّر مساحة النافذة وجرّب تكبير النص أثناء الفحص، ثم انقل المكوّن إلى مشروعك بعد تحديد سياق قيوده الفعلي.
import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class DemoPage extends StatefulWidget {
const DemoPage({super.key});
@override
State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> {
final _controller = ScrollController();
String _status = 'At start';
@override
void initState() { super.initState(); _controller.addListener(_check); }
void _check() {
if (!_controller.hasClients || !_controller.position.hasContentDimensions) return;
final p = _controller.position;
final next = p.maxScrollExtent - p.minScrollExtent <= 1 ? 'Content fits' :
p.pixels <= p.minScrollExtent + 1 ? 'At start' : p.pixels >= p.maxScrollExtent - 1 ? 'At end' : 'Between edges';
if (next != _status && mounted) setState(() { _status = next; });
}
void _move(bool end) {
if (!_controller.hasClients || !_controller.position.hasContentDimensions) return;
final p = _controller.position;
_controller.animateTo(end ? p.maxScrollExtent : p.minScrollExtent,
duration: const Duration(milliseconds: 350), curve: Curves.easeOut);
}
@override
void dispose() { _controller.removeListener(_check); _controller.dispose(); super.dispose(); }
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(title: const Text('Scroll boundaries')),
body: Column(children: [
Wrap(spacing: 8, children: [
TextButton(onPressed: () => _move(false), child: const Text('Start')),
TextButton(onPressed: () => _move(true), child: const Text('End')),
]),
Text(_status),
Expanded(child: ListView.builder(controller: _controller, itemExtent: 72, itemCount: 80,
itemBuilder: (_, index) => ListTile(title: Text('Lesson ${index + 1}')))),
]),
);
}مرجع الواجهة البرمجية
راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.







