شارك المقالة
استعادة موضع ScrollController يدويًا داخل جلسة Flutter

استعادة موضع ScrollController يدويًا داخل جلسة Flutter

استعادة موضع ScrollController في Flutter من لقطة محفوظة داخل الجلسة، مع keepScrollOffset ومعالجة تغير حدود القائمة وتحديد الفرق عن PageStorage…

استعادة موضع ScrollController في Flutter من لقطة محفوظة داخل الجلسة، مع keepScrollOffset ومعالجة تغير حدود القائمة وتحديد الفرق عن PageStorage والتخزين الدائم.

سياسة يدوية بدل تكرار درس آخر

هذه المقالة كانت تكرر مثال PageStorage نفسه، لذلك نركز هنا على اختيار مختلف: نلتقط offset عند مغادرة القائمة داخل shell ثم نمرره إلى controller جديد عند العودة. الفكرة مفيدة لفهم الملكية وتوقيت الاستعادة قبل ربطها بمخزن فعلي. القيمة تبقى في State الأب فقط، ولا تُكتب تلقائيًا إلى القرص ولا تبقى بعد إنهاء العملية. إذا كان المطلوب مجرد تبديل تبويبات ضمن نطاق ثابت فقد يكون PageStorage أبسط وأقل كودًا من تنفيذ السياسة يدويًا.

مالك اللقطة ومالك controller

الأب يحتفظ بـ double تمثل اللقطة، بينما صفحة القائمة تنشئ ScrollController في initState وتنهيه في dispose. عند الضغط على Pause list نقرأ offset بعد التحقق من hasClients ثم نزيل القائمة. العودة تنشئ نسخة جديدة من المكوّن بالقيمة المسجلة. لا تحتفظ بـ State صفحة تم التخلص منها أو تنقل controller إلى صفحة أخرى بلا عقد واضح؛ الاحتفاظ برقم له عمر بسيط يختلف عن الاحتفاظ بمورد مرتبط بشجرة عرض قديمة.

إيقاف الحفظ المنافس

نضبط keepScrollOffset: false في المثال كي لا تتنافس قيمة PageStorage مع initialScrollOffset الذي نريد اختباره. هذه ليست توصية لتعطيل الخاصية في كل مشروع؛ إنها تجعل مصدر الاستعادة واحدًا معلومًا هنا. initialScrollOffset يستخدم عند إنشاء الموضع، وتغييره كحقل widget لاحقًا لا يحرك controller الموجود تلقائيًا. إذا أردت استجابة لتغيير وارد في كائن حي فحدد وقت الانتقال وعقده، ولا تعتمد إعادة build كأنها أمر jumpTo ضمني.

الحدود بعد التخطيط

قبل إنشاء القائمة لا تتوفر حدود المحتوى النهائية دائمًا، لذلك يحتاج إصلاح offset قديم إلى انتظار التخطيط ثم قراءة minScrollExtent وmaxScrollExtent. نراجع hasClients وhasContentDimensions ونحصر القيمة ضمن الحدود المتاحة قبل jumpTo عند الحاجة. المثال ثابت الارتفاع وعدد العناصر لتكون العملية قابلة للتجربة. مع تحميل غير متزامن أو قياس كسول قد تتغير الحدود مرة أخرى، فتحتاج انتظار البيانات المطلوبة أو سياسة مبنية على هوية عنصر بدل القفز المبكر إلى تقدير غير نهائي.

البكسل ليس معرفًا

إذا أضيفت صفوف قبل الموضع المحفوظ فقد يستعيد الرقم مكانًا مختلفًا من منظور المستخدم. كذلك تبديل الخط أو العرض يغير ارتفاعات النصوص في القوائم المتغيرة. لا تسمه حفظ آخر مقال ما دمت تخزن offset وحده، ولا تعد باستعادة دقيقة بين إصدارات ببيانات مختلفة. عند الحفظ الدائم حدد هوية القائمة والمرشح والمستخدم وإصدار البيانات مع ما يلزم من الخصوصية والصلاحية؛ حفظ رقم عام باسم scroll لكل الشاشات ينتج خلطًا يصعب تشخيصه.

فحص التجربة

مرر إلى منتصف القائمة واضغط Pause list ثم Resume list؛ ينبغي أن يعود الموضع داخل الجلسة. جرّب لقطة أكبر من حدود قائمة أقصر ضمن الاختبار وتأكد من الحصر، واختبر قيمة صفر وحالة لا تتصل فيها القائمة بعد. لا تضع قراءة offset في build على افتراض وجود attachment من أول إطار. المثال لا يرسل بيانات ولا يحفظ تفضيلات دائمة، ويهدف لشرح إدارة العمر ومصدر الاستعادة. اختبر على بيانات منتجك قبل توسيعه إلى صفحات طويلة أو محتوى متغير الارتفاع.

مثال مستقل للتجربة

شغّل المثال داخل مشروع 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> {
  double _saved = 0;
  bool _visible = true;
  final _listKey = GlobalKey<SnapshotListState>();
  void _toggle() {
    if (_visible) _saved = _listKey.currentState?.offset ?? _saved;
    setState(() { _visible = !_visible; });
  }
  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('Manual session snapshot')),
    body: Column(children: [
      TextButton(onPressed: _toggle, child: Text(_visible ? 'Pause list' : 'Resume list')),
      Expanded(child: _visible ? SnapshotList(key: _listKey, initialOffset: _saved) : const Center(child: Text('List removed; snapshot stays in the parent'))),
    ]),
  );
}
class SnapshotList extends StatefulWidget {
  const SnapshotList({super.key, required this.initialOffset, this.count = 80});
  final double initialOffset;
  final int count;
  @override
  State<SnapshotList> createState() => SnapshotListState();
}
class SnapshotListState extends State<SnapshotList> {
  late final ScrollController _controller;
  double get offset => _controller.hasClients ? _controller.offset : widget.initialOffset;
  @override
  void initState() {
    super.initState();
    _controller = ScrollController(initialScrollOffset: widget.initialOffset, keepScrollOffset: false);
    WidgetsBinding.instance.addPostFrameCallback((_) {
      if (!mounted || !_controller.hasClients || !_controller.position.hasContentDimensions) return;
      final p = _controller.position;
      final target = widget.initialOffset.clamp(p.minScrollExtent, p.maxScrollExtent).toDouble();
      if ((p.pixels - target).abs() > 0.1) _controller.jumpTo(target);
    });
  }
  @override
  void dispose() { _controller.dispose(); super.dispose(); }
  @override
  Widget build(BuildContext context) => ListView.builder(
    controller: _controller, itemExtent: 72, itemCount: widget.count,
    itemBuilder: (_, index) => ListTile(title: Text('Snapshot item ${index + 1}')),
  );
}

مرجع الواجهة البرمجية

راجع التوثيق الرسمي لمطابقة السلوك مع إصدار Flutter المستخدم. نجاح المثال في مساحة واحدة لا يثبت توافق التصميم مع جميع الشاشات؛ اختبر حدود الانتقال والاتجاه واللغة والنص الطويل.

الصور والفيديو من الشرح السابق

الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.

How to save scroll user behavior in Flutter
شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع