Widget Screenshot Plus - Flutter Package #

This package is a Fork of widget_screenshot updated to the lasted version of flutter and dart.

A Flutter package for capturing widgets as images, including scrollable content and complex layouts. Perfect for sharing app content, creating previews, or saving widget states.

Features #

• 📸 Capture any widget as an image
• 🖼️ Handle scrollable content (ListView, CustomScrollView, etc.)
• 🎨 Customize output format (PNG/JPEG) and quality
• 🖌️ Add background colors to screenshots
• 📱 Support for high DPI screens with pixel ratio control
• 🧩 Merge multiple images into one composition

Android #

IOS #

Installation #

Add to your pubspec.yaml:

dependencies:
  widget_screenshot_plus: ^latest_version

Basic Usage #

1. Wrap your widget #

WidgetShotPlus(
  key: _screenshotKey,
  child: YourWidget(),
)

2. Capture the screenshot #

final boundary = _screenshotKey.currentContext?.findRenderObject()
        as WidgetShotPlusRenderRepaintBoundary?;

final imageBytes = await boundary?.screenshot(
  format: ShotFormat.png,
  quality: 100,
);

Examples #

Simple Widget Capture #

// Wrap your widget
WidgetShotPlus(
  key: _screenshotKey,
  child: Container(
    color: Colors.blue,
    child: Text('Capture me!'),
  ),
)

// Capture it
final imageBytes = await boundary.screenshot();

Scrollable Content #

// Use with scroll controller
final _scrollController = ScrollController();

WidgetShotPlus(
  key: _screenshotKey,
  child: ListView(
    controller: _scrollController,
    children: [...],
  ),
)

// Capture entire scrollable content
final imageBytes = await boundary.screenshot(
  scrollController: _scrollController,
);

Save and Share #

// Save to file
final dir = await getApplicationDocumentsDirectory();
final imageFile = File('${dir.path}/screenshot.png');
await imageFile.writeAsBytes(imageBytes!);

// Share using share_plus
await Share.shareXFiles([XFile(imageFile.path)]);

Advanced Options #

FAQ #

Q: Can I capture widgets that are not currently visible on screen?
A: Yes! The package can capture the entire widget tree regardless of visibility.

Q: How does it handle platform differences?
A: The package uses a platform interface with method channel implementation, ensuring consistent behavior across iOS and Android.

Limitations #

• Very large captures may cause memory issues (consider splitting extremely long content)
• Web support requires canvas-based rendering
• Some platform-specific widgets may render differently in screenshots

Contributing #

Contributions are welcome! Please open issues or pull requests for any bugs or feature suggestions.

License #

MIT - See LICENSE for details.