شاشة التقويم تبدو شبكة فيها مربعات ملوّنة، وأغلب العمل في الحالات التي لا تُظهرها الشبكة. ثلاثة اجتماعات تتداخل عند 10:00 وكل واحد يحتاج عموده. حدث يدوم ثلاثة أيام ويجب أن يمتد فوق عدة خانات. المستخدم يضغط مطولًا على مربع ويسحبه إلى يوم آخر. "كل يوم عمل على 08:30 ما عدا يوم 25" يجب أن يتحول إلى مواعيد فعلية. وبالعربية، الأيام تسير من اليمين إلى اليسار وتسميات الوقت تنتقل إلى الجهة الأخرى. ومستخدم قارئ الشاشة يحتاج أن يسمع كل حدث وأن يحرّكه دون سحب.

time_grid_calendar حزمة (package) لـ Flutter فيها واجهات اليوم، و3 أيام، والأسبوع، والشهر، شبيهة بـ Google Calendar. الأحداث يمكن أن تتداخل، وأن تُسحب ويُغيَّر طولها، وأن تتكرر بقواعد RRULE. الواجهات تعمل من اليمين إلى اليسار ومع قارئات الشاشة، والحزمة بلا اعتماديات تجارية.

ماذا تقدّم

أحداث عامة النوع (generic). CalendarEvent<T> فيه id وبداية ونهاية وعلامة "طوال اليوم" وعنوان ولون وpayload له نوع، فتستطيع ربط نموذجك الخاص بكل حدث. الأحداث تأتي من EventController، أو من دالة تحميل لمجال زمني، متزامنة أو غير متزامنة: loadEvents(DateTimeRange).

TimeGridView من يوم إلى 7 أيام. widget واحد يغطي واجهات اليوم و3 أيام والأسبوع:

  • ارتفاع الساعة، وساعة البداية والنهاية، وتسميات الوقت (12 ساعة أو 24 ساعة، حسب الـ locale عبر intl) كلها قابلة للضبط.
  • الأحداث المتداخلة توضع جنبًا إلى جنب. تستعمل الواجهة التخطيط المعروف: مجموعات (clusters)، ثم توزيع على الأعمدة، ثم تمدّد في الأعمدة الفارغة.
  • صف مثبَّت لأحداث "طوال اليوم" يكبر حسب الحاجة، والأحداث متعددة الأيام أشرطة تمتد على أيامها.
  • خط "الآن"، والشبكة تنتقل إلى الوقت الحالي عند فتحها.
  • التنقل بين المجالات الزمنية بالسحب عبر PageView، مع الحفاظ على موضع التمرير العمودي.
  • النقر على خانة فارغة ينشئ حدثًا، مع المحاذاة إلى 15 أو 30 دقيقة، أو أي قاسم للعدد 60.
  • الضغط المطوّل والسحب ينقل الحدث، وسحب حافته السفلى يغيّر طوله. كلاهما يحاذي، والـ callback الخاص بك يستطيع رفض التغيير.
  • eventBuilder يستبدل محتوى مربع الحدث.

MonthView. شبكة 6×7. أول يوم في الأسبوع يتبع الـ locale. الأحداث متعددة الأيام أشرطة تمتد فوق الخانات، والأحداث الزائدة تُجمع في "+N more"، والأيام والأحداث و"+N more" كلها قابلة للنقر.

عناصر التنقل. WeekdayHeader، وCalendarViewController (التالي، السابق، القفز إلى تاريخ، والمجال الظاهر)، وCalendarNavigation (الأيام الظاهرة، وعناوين المجال مثل "Sep – Oct 2026").

التكرار. توسيع RRULE يتم بتوقيت الساعة (wall-clock)، فـ"كل يوم على 09:00" يبقى على 09:00 مع تغيّر التوقيت الصيفي (DST). مبني على حزمة rrule التي ما زالت تُصان، ويضيف WKST غير الاثنين، وUNTIL بتاريخ فقط، وEXDATE. وRecurringEventSeries يوسّع حدثًا أصليًا إلى مواعيده، وتستطيع تعديل موعد واحد منها عبر الـ controller.

اللغات. واجهات RTL تنعكس: تسميات الوقت تنتقل إلى اليمين والأيام تسير من اليمين إلى اليسار. أسماء الأيام والشهور والأوقات تأتي من intl، بالفرنسية والعربية مثلًا. وتسميات قارئ الشاشة مرفقة بالإنجليزية والفرنسية والعربية.

إمكانية الوصول. لكل حدث تسمية semantics فيها عنوانه ومجاله الزمني. مفتاح Tab ينقل التركيز بين الأحداث، والأسهم تحرّكها، و Shift مع السهم الأعلى أو الأسفل يغيّر طولها، و Enter أو Space يفتحها. وقارئات الشاشة تحصل على إجراءات مخصصة: تقديم الحدث، تأخيره، نقله إلى اليوم السابق، نقله إلى اليوم التالي، تقصيره وتمديده.

الأداء. تُبنى الصفحة الظاهرة فقط، وتخطيط اليوم يُحفظ (cache) حسب اليوم وحسب hash أحداثه.

طريقة الاستعمال

أضِفها من GitHub:

dependencies: time_grid_calendar: git: https://github.com/AbdeldjalilChougui/time_grid_calendar 

للفرنسية والعربية وبقية اللغات، أضِف flutter_localizations إلى تطبيقك كالعادة.

واجهة أسبوع فيها حدث واحد، وسلسلة متكررة، و callbacks التعديل:

import 'package:flutter/material.dart'; import 'package:time_grid_calendar/time_grid_calendar.dart'; class _WeekPageState extends State<WeekPage> { final events = EventController<String>(events: [ CalendarEvent( id: '1', start: DateTime(2026, 9, 24, 9), end: DateTime(2026, 9, 24, 10, 30), title: 'Design review', color: Colors.teal, payload: 'room 4', ), ]); final view = CalendarViewController(); @override void initState() { super.initState(); events.addSeries(RecurringEventSeries( master: CalendarEvent( id: 'standup', start: DateTime(2026, 9, 1, 8, 30), end: DateTime(2026, 9, 1, 8, 45), title: 'Standup', ), rrule: 'FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR', exdates: [DateTime(2026, 9, 25, 8, 30)], )); } @override Widget build(BuildContext context) { return Scaffold( body: TimeGridView<String>( controller: events, numberOfDays: 7, // 1 = day, 3 = 3-day, 7 = week snapMinutes: 15, viewController: view, onSlotTap: (start) => events.add(CalendarEvent( id: '${start.millisecondsSinceEpoch}', start: start, end: start.add(const Duration(hours: 1)), title: 'New event', )), onEventTap: (e) => debugPrint('${e.title} ${e.payload}'), // Return false, or a Future of false, to veto the change. onEventMove: (event, newStart, newEnd) => true, onEventResize: (event, newStart, newEnd) async => true, ), ); } } 

هذا مثال الـ README دون الـ app bar ودون دالة dispose. في كودك، تخلّص من الـ controller-ين في dispose، واستدعِ view.previous وview.next من أزرارك.

واجهة شهر مع دالة تحميل غير متزامنة:

Widget month(Future<List<CalendarEvent<String>>> Function(DateTimeRange) fetch) => MonthView<String>( loadEvents: fetch, // called once per visible 6-week range onDayTap: (day) => debugPrint('day $day'), onEventTap: (event) => debugPrint(event.title), onMoreTap: (day, events) => debugPrint('${events.length} on $day'), ); 

لإعادة تحميل البيانات، أنشئ EventController<T>.withLoader(...) بنفسك واستدعِ reload().

ومحرّك التكرار يعمل أيضًا دون الـ widgets:

final starts = expandRecurrence( rrule: 'RRULE:FREQ=MONTHLY;BYDAY=-2MO;COUNT=6', start: DateTime(1997, 9, 22, 9), rangeStart: DateTime(1997, 1, 1), rangeEnd: DateTime(1999, 1, 1), ); 

كيف تُفهم الأوقات

هذا هو قرار التصميم الذي يجب فهمه قبل استعمال الحزمة: هي لا تستعمل المناطق الزمنية. تقرأ الـ DateTime عبر حقوله فقط (السنة، الشهر، اليوم، الساعة، الدقيقة)، وليس كلحظة زمنية، وتُجري حساب الأيام والدقائق على هذه الحقول. ويترتب على ذلك أمران:

  • الحدث الذي على 09:00 يُرسم عند 09:00. والحدث المتكرر على 09:00 يبقى على 09:00 مع تغيّر التوقيت الصيفي.
  • اجعل كل القيم في التقويم الواحد إما محلية أو UTC. القيم المعلَّمة UTC والمستعملة كأوقات ساعة "عائمة" هي الاختيار الأمتن: الـ DateTime المحلي لا يستطيع تمثيل وقت يقع في فجوة تقديم الساعة (Dart يحوّل 02:30 إلى 03:30)، وقيم UTC تستطيع.

وقيم UNTIL في القواعد تُقرأ كأوقات ساعة أيضًا، مع Z في آخرها أو بدونه.

أشياء يجب معرفتها

  • لا يوجد تحويل بين المناطق الزمنية. حوّل القيم إلى توقيت الساعة قبل تسليم الأحداث للواجهات.
  • دعم WKST جزئي. قيمة WKST غير MO مدعومة لقواعد WEEKLY مع BYDAY، لأن RFC 5545 يقول إن هذا هو الموضع الذي تؤثر فيه. وهي غير مدعومة مع BYWEEKNO أو BYSETPOS أو بقية أجزاء BY* في تلك القواعد، وهذه التركيبات ترمي FormatException.
  • غير موجود: RDATE وEXRULE والتحليل الكامل لصيغة iCalendar.
  • عرض التقويم الهجري غير موجود.
  • السحب يبقى داخل الصفحة الظاهرة. لنقل الحدث أبعد من ذلك، استعمل لوحة المفاتيح أو إجراءات الـ semantics، أو انتقل إلى الصفحة أولًا ثم اسحب.
  • الأحداث التي تعبر منتصف الليل تُرسم في عمود كل يوم في شبكة الوقت. ولا تظهر في صف "طوال اليوم".
  • ما الذي تتحقق منه الاختبارات. اختبارات التكرار تتحقق من الأمثلة المحلولة في RFC 5545، القسم 3.8.5.3. ولا توجد بيانات مرفقة: أول أيام الأسبوع وصيغ التواريخ تأتي من بيانات CLDR الموجودة في حزمة intl.

لماذا بنيتها

الفقرة الأولى في الـ README تنتهي بعبارة "No commercial dependencies"، وهذه هي المشكلة باختصار: تقويم فيه شبكة وقت، وأحداث متداخلة، وسحب وتغيير للمدة، وتكرار، برخصة MIT، ودون شيء يُشترى.

والجزء الآخر هو ما يُترك غالبًا إلى وقت لاحق. دعم RTL هنا ليس خيارًا أضيف في النهاية: الشبكة تنعكس، والتسميات تأتي من intl. وإمكانية الوصول ليست تسميات فقط: لكل عملية سحب اختصار في لوحة المفاتيح وإجراء لقارئ الشاشة، فنقل الحدث لا يحتاج إصبعًا على الشاشة. والتكرار يُعامل بتوقيت الساعة عن قصد، لأن اجتماع 09:00 الذي ينزاح ساعة مرتين في السنة خطأ يلاحظه المستخدمون.

احصل على الكود

المصدر، والمثال، والاختبارات، كلها على GitHub: https://github.com/AbdeldjalilChougui/time_grid_calendar. الرخصة MIT. الملاحظات (issues) وطلبات الدمج (pull requests) مرحّب بها.

نُشر في الأصل على abdeldjalilchougui.biz.