🐛 Bug Fixes #

• Alternative to Buggy Flutter loadingBuilder: Implemented custom loading state management to replace Flutter's problematic loadingBuilder
  • Replaced loadingBuilder parameter with customLoadingBuilder that uses CustomImageProgress
  • Added reliable progress tracking via ImageStream and ImageStreamListener
  • Fixed memory leaks and inconsistent progress reporting issues
  • Added proper resource cleanup with _cleanupImageStream() method

🚀 New Features #

• Custom Loading Progress Tracking: New CustomImageProgress class provides reliable loading progress information
• Enhanced Loading State Management: Added ImageLoadingState enum for better loading state control
• Improved Resource Management: Automatic cleanup of image streams and listeners to prevent memory leaks

🔄 Migration Guide #

// OLD (buggy Flutter loadingBuilder)
CustomNetworkImage(
  url: imageUrl,
  loadingBuilder: (context, child, loadingProgress) {
    if (loadingProgress == null) return child;
    return CircularProgressIndicator(
      value: loadingProgress.cumulativeBytesLoaded / 
             loadingProgress.expectedTotalBytes!,
    );
  },
)

// NEW (reliable customLoadingBuilder)
CustomNetworkImage(
  url: imageUrl,
  customLoadingBuilder: (context, child, progress) {
    if (progress == null) return child;
    return Column(
      mainAxisSize: MainAxisSize.min,
      children: [
        CircularProgressIndicator(value: progress.progress),
        if (progress.progress != null)
          Text('${(progress.progress! * 100).toInt()}%'),
      ],
    );
  },
)

🛠️ Technical Changes #

• Manual image loading progress tracking via onChunk callback
• Proper state management for loading, loaded, and failed states
• Enhanced error handling integration with existing fallback mechanisms
• Backward compatibility maintained for existing error handling features

🚀 New Features #

• Widget-based Error Handling: Introduced new widget parameters for more flexible error UI customization:
  • errorWidget - Custom widget to show when image fails to load
  • reloadWidget - Custom widget for retry functionality
  • openUrlWidget - Custom widget for opening image URL in new tab
• Flutter-based Error UI: HTML errors now callback to Flutter for consistent error handling across platforms
• Enhanced Error Flow: When HTML image loading fails, errors are now handled in Flutter using the new widget parameters

⚠️ Breaking Changes #

• HTML Error Handling: HTML errors no longer show HTML-based error UI. Instead, they trigger Flutter callbacks for consistent widget-based error handling.
• Deprecated Parameters: The following string-based parameters are now deprecated and will be removed in v1.0.0:
  • errorText → Use errorWidget instead
  • reloadText → Use reloadWidget instead
  • openUrlText → Use openUrlWidget instead

🔄 Migration Guide #

// OLD (deprecated but still works)
CustomNetworkImage(
  url: imageUrl,
  errorText: 'Image failed to load',
  reloadText: 'Reload Image',
  openUrlText: 'Open in New Tab',
)

// NEW (recommended)
CustomNetworkImage(
  url: imageUrl,
  errorWidget: Row(
    mainAxisSize: MainAxisSize.min,
    children: [
      Icon(Icons.error, color: Colors.red),
      SizedBox(width: 8),
      Text('Image failed to load'),
    ],
  ),
  reloadWidget: Row(
    mainAxisSize: MainAxisSize.min,
    children: [
      Icon(Icons.refresh),
      SizedBox(width: 8),
      Text('Reload Image'),
    ],
  ),
  openUrlWidget: Row(
    mainAxisSize: MainAxisSize.min,
    children: [
      Icon(Icons.open_in_new),
      SizedBox(width: 8),
      Text('Open in New Tab'),
    ],
  ),
)

🛠️ Technical Changes #

• Added HTML error callback mechanism for Flutter integration
• Removed HTML-based error UI generation from web_image_loader.dart
• Enhanced CustomNetworkImage state management for error handling
• Improved backward compatibility with automatic fallback from deprecated parameters

📚 Documentation #

• Updated examples to demonstrate new widget-based error handling
• Added migration guide in example app
• Updated README with v0.2.0 usage patterns

• Fixed: Resolved issue where error placeholder was not being displayed correctly
• Fixed: Resolved issue where error placeholder was not being displayed correctly

• Fixed: Resolved issue where error placeholder was not being displayed correctly
• Fixed: Resolved issue where error placeholder was not being displayed correctly

• Added: Internationalization support for error handling - supports custom text for error messages and buttons
• Enhanced: Error placeholder now includes reload and "open in new tab" functionality when HTML image loading fails
• Added: errorText, reloadText, and openUrlText parameters to CustomNetworkImage for multilingual support
• Improved: Error UI can show only icons when no text is provided (icon-only mode for universal understanding)
• Added: Reload button to retry failed images without page refresh
• Added: "Open in new tab" button to view the problematic image URL directly

• Fixed: Resolved tap event conflicts in ListViews with mixed HTML fallback and normal images
• Update README.md

• Fixed: Resolved tap event conflicts in ListViews with mixed HTML fallback and normal images
• Added: Per-image tap callback tracking to prevent event confusion
• Added: uniqueId parameter to CustomNetworkImage for better control in lists
• Improved: Event propagation handling with stopPropagation() to isolate tap events
• Added: Proper cleanup of resources when widgets are disposed

• Fixed: Dramatically improved smoothness of panning/dragging in InteractiveViewer with HTML fallback images
• Added: Animation controller for continuous transformation updates during gestures
• Improved: Full matrix transformation for more accurate CSS transforms
• Fixed: Pointer events handling for smoother gesture recognition

• Fixed: InteractiveViewer zoom functionality now works with HTML fallback images
• Added: TransformationController support for CustomNetworkImage
• Improved: Object-fit set to 'contain' for better zooming behavior
• Fixed: Proper transformation handling for HTML elements

• Fixed: GestureDetector tap events now work correctly with problematic images using HTML fallback
• Added: onTap callback property to CustomNetworkImage for easier tap handling
• Improved: Visual feedback with cursor pointer on HTML fallback images

• Updated intl dependency to support a wider range of versions (>=0.19.0 <0.21.0)
• Improved compatibility with projects that depend on intl 0.19.0

• Initial release with image loading solution:
  • CustomNetworkImage: Uses HTML img tag as fallback
• Support for all standard Image.network parameters
• Full web platform support for problematic images
• Example app showing how to use the approach