Watch
1
0
Fork
You've already forked arc
0
forked from hesabix/arc
arc/hesabixUI/hesabix_ui/lib/widgets/data_table/BUGFIXES_SUMMARY.md
2026-04-14 19:34:55 +03:30

4 KiB
Executable file

خلاصه اصلاحات مشکلات تنظیمات ستون‌ها

مشکلات حل شده

1. ✅ مشکل نمایش ستون‌های مخفی در دیالوگ تنظیمات

مشکل: بعد از مخفی کردن یک ستون و رفرش صفحه، این ستون در لیست تنظیمات ستون‌ها نمایش داده نمی‌شد.

علت: در دیالوگ تنظیمات، لیست widget.columns تغییر می‌کرد و ستون‌های مخفی شده از لیست حذف می‌شدند.

راه‌حل:

  • ایجاد کپی محلی از لیست ستون‌ها (_columns) در دیالوگ
  • استفاده از کپی محلی به جای widget.columns در تمام عملیات

2. ✅ مشکل دکمه "بازگردانی به پیش‌فرض"

مشکل: دکمه "بازگردانی به پیش‌فرض" کار نمی‌کرد.

علت: استفاده از widget.columns به جای کپی محلی.

راه‌حل: تغییر مراجع به _columns در تابع _resetToDefaults().

3. ✅ جابجایی دکمه تنظیمات ستون‌ها

مشکل: دکمه تنظیمات ستون‌ها باید بعد از دکمه رفرش قرار گیرد.

راه‌حل: جابجایی کد دکمه تنظیمات ستون‌ها به بعد از دکمه رفرش در _buildHeader().

4. ✅ جلوگیری از مخفی کردن همه ستون‌ها

مشکل: امکان مخفی کردن همه ستون‌ها وجود داشت که باعث نمایش خالی جدول می‌شد.

راه‌حل:

  • در دیالوگ: اضافه کردن چک if (_visibleColumns.length > 1) قبل از حذف ستون
  • در checkbox "همه": نگه داشتن حداقل یک ستون هنگام uncheck کردن
  • در سرویس: اضافه کردن منطق if (visibleColumns.isEmpty && defaultColumnKeys.isNotEmpty)
  • در DataTableWidget: اضافه کردن تابع _validateColumnSettings()

تغییرات فایل‌ها

1. column_settings_dialog.dart

// اضافه شدن کپی محلی از ستون‌ها
late List<DataTableColumn> _columns;

// جلوگیری از مخفی کردن همه ستون‌ها
if (_visibleColumns.length > 1) {
  _visibleColumns.remove(column.key);
}

// نگه داشتن حداقل یک ستون در checkbox "همه"
_visibleColumns = [_columns.first.key];

2. data_table_widget.dart

// جابجایی دکمه تنظیمات ستون‌ها
// اضافه شدن تابع اعتبارسنجی
ColumnSettings _validateColumnSettings(ColumnSettings settings) {
  if (settings.visibleColumns.isEmpty && widget.config.columns.isNotEmpty) {
    return settings.copyWith(
      visibleColumns: [widget.config.columns.first.key],
      columnOrder: [widget.config.columns.first.key],
    );
  }
  return settings;
}

3. column_settings_service.dart

// اضافه شدن منطق جلوگیری از مخفی کردن همه ستون‌ها
if (visibleColumns.isEmpty && defaultColumnKeys.isNotEmpty) {
  visibleColumns.add(defaultColumnKeys.first);
}

تست‌های اضافه شده

1. column_settings_validation_test.dart

  • تست جلوگیری از مخفی کردن همه ستون‌ها
  • تست حفظ ستون‌های موجود
  • تست فیلتر کردن ستون‌های نامعتبر
  • تست حفظ ترتیب ستون‌ها

نتیجه

همه مشکلات مطرح شده با موفقیت حل شدند:

  1. ✅ ستون‌های مخفی در دیالوگ تنظیمات نمایش داده می‌شوند
  2. ✅ دکمه "بازگردانی به پیش‌فرض" کار می‌کند
  3. ✅ دکمه تنظیمات ستون‌ها بعد از دکمه رفرش قرار دارد
  4. ✅ همیشه حداقل یک ستون در حالت نمایش باقی می‌ماند

سیستم اکنون کاملاً پایدار و کاربرپسند است.