hyper_render_clipboard

Image clipboard operations for HyperRender. Copy actual image data (not just URLs), save to device storage, and share via the system share sheet — built on super_clipboard.

Installation

dependencies:
  hyper_render_clipboard: ^1.7.3

Usage

With HyperViewer

import 'package:hyper_render/hyper_render.dart';
import 'package:hyper_render_clipboard/hyper_render_clipboard.dart';

final clipboard = SuperClipboardHandler();

HyperViewer(
  html: '<img src="https://example.com/photo.jpg">',
  // HyperViewer has no clipboard parameter: hand images to HyperImage yourself.
  widgetBuilder: (node) {
    if (node is AtomicNode && node.tagName == 'img' && node.src != null) {
      return HyperImage(
        src: node.src!,
        width: node.intrinsicWidth ?? node.style.width,
        height: node.intrinsicHeight ?? node.style.height,
        clipboardHandler: clipboard,
      );
    }
    return null; // everything else renders as usual
  },
)

Long-pressing a HyperImage shows Copy / Save / Share. Without a clipboardHandler the built-in images offer URL copy only.

Standalone

final handler = SuperClipboardHandler();

await handler.copyImageFromUrl('https://example.com/photo.jpg');

final path = await handler.saveImageFromUrl(
  'https://example.com/photo.jpg',
  filename: 'my_photo.jpg',
);

await handler.shareImageFromUrl(
  'https://example.com/photo.jpg',
  text: 'Check this out!',
);

From bytes

final Uint8List imageBytes = ...;

await handler.copyImageBytes(imageBytes, mimeType: 'image/png');
await handler.saveImageBytes(imageBytes, filename: 'screenshot.png');
await handler.shareImageBytes(imageBytes, text: 'Created with MyApp!');

Platform support

Platform	Copy	Save	Share	Setup
macOS	✅	✅	✅	Add `com.apple.security.network.client` entitlement
Windows	✅	✅	✅	None
Linux	✅	✅	✅	Install `xclip`
iOS	✅	✅	✅	Add `NSAllowsArbitraryLoads` to Info.plist
Android	✅	✅	✅	Add `INTERNET` permission to AndroidManifest.xml
Web	⚠️	❌	✅	HTTPS + CORS required

Supported formats

PNG, JPEG, GIF, WebP, BMP, TIFF

HyperRender Ecosystem

Package	Description
hyper_render	Main package — `HyperViewer` widget, HTML + Markdown rendering
hyper_render_core	Core engine: UDT model, `RenderHyperBox`, plugin API
hyper_render_html	HTML + CSS → UDT parser
hyper_render_markdown	Markdown (GFM) → UDT parser
hyper_render_highlight	Syntax highlighting for `<code>` / `<pre>` blocks
hyper_render_epub	EPUB 2/3 reader container & archive decoder (opt-in)
hyper_render_clipboard	Image copy / save / share ← you are here
hyper_render_math	LaTeX / MathML rendering (opt-in)
hyper_render_devtools	Flutter DevTools inspector

Source · Issues · Changelog

License

MIT — see LICENSE.