improve image lifecycle handling

2026-02-08 17:37:21 +01:00
parent 6f3a84fb31
commit d1e769fb7c
14 changed files with 126 additions and 51 deletions
@@ -0,0 +1,59 @@
+/*
+ * Copyright (c) 2024-2026 Fabian Freund.
+ *
+ * This file is part of WebLibre
+ * (see https://weblibre.eu).
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+import 'package:flutter/widgets.dart';
+import 'package:weblibre/domain/entities/equatable_image.dart';
+
+/// A safe wrapper around [RawImage] that guards against disposed images.
+///
+/// Checks [EquatableImage.isDisposed] before rendering. When the image
+/// is null or disposed, renders [fallback] (defaults to an empty SizedBox
+/// matching the requested dimensions).
+class SafeRawImage extends StatelessWidget {
+  final EquatableImage? image;
+  final double? width;
+  final double? height;
+  final BoxFit? fit;
+  final Widget? fallback;
+
+  const SafeRawImage({
+    super.key,
+    required this.image,
+    this.width,
+    this.height,
+    this.fit,
+    this.fallback,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    final uiImage = image?.value;
+
+    if (uiImage == null) {
+      return fallback ?? SizedBox(width: width, height: height);
+    }
+
+    return RawImage(
+      image: uiImage,
+      width: width,
+      height: height,
+      fit: fit,
+    );
+  }
+}