شارك المقالة
تغيير التاريخ أعلى القائمة أثناء التمرير في Flutter

تغيير التاريخ أعلى القائمة أثناء التمرير في Flutter

تغيير التاريخ أثناء التمرير في Flutter عبر ربط العنوان بالعنصر الظاهر، مع مثال لعناصر ثابتة الارتفاع وتوضيح حدود الحساب عند…

تغيير التاريخ أثناء التمرير في Flutter عبر ربط العنوان بالعنصر الظاهر، مع مثال لعناصر ثابتة الارتفاع وتوضيح حدود الحساب عند اختلاف المقاسات.

العنوان يعكس العنصر المعروض

تريد هذه الواجهة عرض تاريخ العنصر الموجود قرب أعلى القائمة بدل تاريخ ثابت لا يتغير. المصدر schedule_app مفيد لدراسة نموذج الأحداث وعرض التاريخ، لكن ربط العنوان بموضع التمرير يحتاج عقدًا واضحًا. لا تستخدم DateTime.now لكل عنصر إذا كانت البيانات تحتوي وقت نشر مختلفًا. حدد كذلك هل التاريخ يعرض بتوقيت المستخدم أو UTC، ونفذ التحويل قبل تجميع العناصر بحسب اليوم.

متى تصلح قسمة offset على ارتفاع العنصر؟

تصلح في مثال له itemExtent ثابت، وتبدأ عناصره مباشرة بعد بداية القائمة دون رأس مضمّن يغير الحساب. عندها يعطي floor(offset / extent) فهرس أول عنصر، مع تقييده بحدود البيانات. إذا كان كل منشور له نص وصورة بارتفاع متغير فهذه المعادلة لا تكفي؛ استخدم آلية معرفة العناصر المرئية أو slivers برؤوس مجموعات وفق تصميمك. لا تقدم خوارزمية الارتفاع الثابت كحل عام لكل Feed.

تحديث محدود وإدارة الموارد

استمع إلى ScrollController مرة، ولا تحدث state في كل بكسل إذا كان فهرس العنصر لم يتغير. ألغِ المستمع وحرر controller في dispose. عند تغير القائمة قيد الفهرس أو أعده وفق سياسة تحديث واضحة، ولا تقرأ عنصرًا محذوفًا بفهرس قديم. تجنب network request في callback التمرير لكل حركة؛ التاريخ يأتي من البيانات المحملة، ويمكن فصل تحميل الصفحة التالية بآلية مستقلة.

قائمة فارغة وتنسيق التاريخ

يعرض المثال حالة خالية بدل طلب dates[0] عندما لا توجد عناصر. تنسيق اليوم والشهر والسنة البسيط في الكود لا يبدل التقويم ولا المنطقة الزمنية؛ استخدم intl إذا احتجت أسماء أشهر أو محلية متقدمة. اجعل عنوان التاريخ مقروءًا عند تكبير الخط، ولا تعطه عرضًا ثابتًا يصطدم بزر أو أيقونة. حافظ على المفاتيح وهوية العناصر إذا تغير ترتيبها بعد جلب دفعة جديدة.

اختبار المثال والمصدر

جرّب أول عنصر وآخر عنصر وقائمة واحدة وقائمة فارغة، ثم تجاوز حدود التمرير والعودة من تفاصيل منشور. المكون أدناه مثال مستقل ثابت الارتفاع، ويمكن مقارنته ببنية schedule_app دون الاعتماد على API خاص بالمصدر. إذا اخترت مكتبة timeline أو تحديد عناصر مرئية فراجع إصدارها وحالات الارتفاع المتغير. لا تحتاج إلى تكرار منطق التاريخ داخل كل بطاقة؛ العنوان يشتق من موضع العرض في مكان واحد.

المثال البرمجي

ضع المكون داخل مشروع Flutter وصفحة مناسبة في MaterialApp. الكود التالي مثال مستقل للجزء المشروح، ولا يعتمد على ملفات تطبيق خارجي غير مرفقة. راجع المتطلبات المذكورة في النص، خاصة الخط والحزم في مثال PDF.

import 'package:flutter/material.dart';

class DatedFixedList extends StatefulWidget {
  const DatedFixedList({super.key, required this.dates});
  final List<DateTime> dates;
  @override
  State<DatedFixedList> createState() => _DatedFixedListState();
}
class _DatedFixedListState extends State<DatedFixedList> {
  static const extent = 124.0;
  final _controller = ScrollController();
  int _index = 0;
  @override
  void initState() { super.initState(); _controller.addListener(_onScroll); }
  void _onScroll() {
    if (widget.dates.isEmpty || !_controller.hasClients) return;
    final next = (_controller.offset / extent).floor().clamp(0, widget.dates.length - 1);
    if (next != _index) setState(() => _index = next);
  }
  @override
  void didUpdateWidget(covariant DatedFixedList oldWidget) {
    super.didUpdateWidget(oldWidget);
    _index = widget.dates.isEmpty ? 0 : _index.clamp(0, widget.dates.length - 1);
  }
  @override
  void dispose() { _controller.removeListener(_onScroll); _controller.dispose(); super.dispose(); }
  String _label(DateTime date) => '${date.day}/${date.month}/${date.year}';
  @override
  Widget build(BuildContext context) {
    if (widget.dates.isEmpty) return const Center(child: Text('لا توجد عناصر'));
    return Column(children: [
      Padding(padding: const EdgeInsets.all(12), child: Text(_label(widget.dates[_index]))),
      Expanded(child: ListView.builder(
        controller: _controller, itemExtent: extent, itemCount: widget.dates.length,
        itemBuilder: (context, index) => Padding(
          padding: const EdgeInsets.all(8), child: Card(
            child: Center(child: Text('عنصر ${index + 1} — ${_label(widget.dates[index])}')),
          ),
        ),
      )),
    ]);
  }
}

المصدر ومراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

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