عرض شجرة بيانات في Flutter يحتاج تعريف العقد ومعرفاتها وأبنائها، ثم اختيار آلية توسع مناسبة لحجم البيانات. الحزمة القديمة flutter_fancy_tree_view معلّمة discontinued في pub.dev وتشير إلى two_dimensional_scrollables بديلًا. لا تصح أسماء واجهات مخترعة مثل FancyTreeNode إذا لم تكن موجودة في الإصدار المقصود.
بديل بسيط للشجرة الصغيرة
يستخدم المثال LessonNode مع ExpansionTile من Flutter لتوضيح البنية دون إضافة مكتبة. العقدة ذات الأبناء قابلة للتوسيع، والورقة ListTile عادية. مناسب لقائمة صغيرة ثابتة، وليس مستكشف ملفات ضخمًا يحتوي آلاف العقد أو تحميلًا عن بعد.
معرف العقدة وحالة التوسع
يجب أن يكون id فريدًا في نطاق الشجرة؛ يستخدم PageStorageKey للاحتفاظ بحالة العنصر ضمن نطاق PageStorage. لا تستخدم النص المعروض وحده معرفًا لأن اسمين قد يتطابقان أو تتغير الترجمة. وحّد نموذج البيانات إذا احتجت اختيار عقد متعددة.
الهجرة من الحزمة القديمة
احصر ما يستخدمه مشروعك من رسم الفروع والسحب والاختيار والتمرير، ثم قارنه بواجهة البديل الفعلية ووثائقه. لا يكفي تغيير اسم import لأن نموذج التحكم قد يختلف. احتفظ بالمشروع القديم في فرع منفصل حتى يتحقق سلوك التوسع والاختيار بعد النقل.
الأداء والوصول
بناء كل الأبناء دفعة واحدة لا يناسب شجرة ضخمة. استخدم تحميلًا كسولًا وتحديد ارتفاع منطقة العرض وقياس البناء إذا كبرت البيانات. اختبر العربية والنص الطويل ولوحة المفاتيح وحالة الفرع الفارغ؛ اختبار المثال يتحقق من ظهور الورقة بعد توسيع الجذر.
مثال تطبيقي
المقطع التالي مستقل في ملف Dart. اختُبر منطق Dart والواجهات المشار إليها، وتبقى إعدادات المنصة والتجربة على جهاز فعلي مطلوبة قبل النشر.
import 'package:flutter/material.dart';
class LessonNode {
const LessonNode(this.id, this.label, [this.children = const []]);
final String id;
final String label;
final List<LessonNode> children;
}
Widget lessonTree(LessonNode node) {
if (node.children.isEmpty) return ListTile(key: ValueKey(node.id), title: Text(node.label));
return ExpansionTile(
key: PageStorageKey(node.id), title: Text(node.label),
childrenPadding: const EdgeInsetsDirectional.only(start: 16),
children: node.children.map(lessonTree).toList(),
);
}
// For small trees. For large/remote trees use a lazy tree with pagination.
تطبيق شجرة بيانات في Flutter في مشروعك
الحزمة معلّمة discontinued في pub.dev وتشير إلى two_dimensional_scrollables بديلًا؛ راجع اختلاف نموذج الشجرة قبل نقل تطبيق قائم.
مراجع الموضوع: pub.dev — flutter_fancy_tree_view، pub.dev — two_dimensional_scrollables






