import 'package:flutter/foundation.dart'; import 'package:flutter/gestures.dart'; import 'package:flutter/widgets.dart'; import 'package:webview_flutter/webview_flutter.dart'; import '../domain/artifact_html_links.dart'; import 'artifact_external_open.dart'; /// The mobile web views pinch-zoom natively (Android's built-in zoom, which /// the plugin turns on with its display controls hidden; WKWebView's own), so /// the full-screen view needs no zoom buttons. const bool inertHtmlZoomButtons = false; /// A web view with JavaScript disabled that refuses every navigation after the /// recorded document itself loads. /// /// A platform view only receives the pointers of gestures that its /// [WebViewWidget.gestureRecognizers] win in Flutter's gesture arena. With /// none it got a drag only after every other recognizer gave up, which the /// viewer's page swipe never does before the finger lifts: the document never /// scrolled or pinched. Inline it claims vertical drags (scrolling the /// document) and leaves horizontal ones to the page swipe; [interactive] (the /// full-screen view) claims every pointer at once, so scroll, pan and pinch /// all reach the document. class InertHtmlView extends StatefulWidget { const InertHtmlView({ super.key, required this.html, this.interactive = false, this.zoom, this.openExternal = openArtifactExternally, }); final String html; /// Opens a link's http(s)/mailto address outside the artifact. final ArtifactExternalOpen openExternal; final bool interactive; /// Unused: the mobile web views pinch instead ([inertHtmlZoomButtons]). final ValueListenable? zoom; @override State createState() => _InertHtmlViewState(); } final _inlineGestures = >{ Factory(VerticalDragGestureRecognizer.new), }; final _allGestures = >{ Factory(EagerGestureRecognizer.new), }; class _InertHtmlViewState extends State { /// Until the recorded document finishes loading, the view may load it (an /// `about:` or `data:` document); afterwards only links are followed. bool _loaded = false; late final WebViewController _controller = WebViewController() ..setJavaScriptMode(JavaScriptMode.disabled) ..enableZoom(true) ..setNavigationDelegate( NavigationDelegate( onPageFinished: (_) => _loaded = true, onNavigationRequest: _decide, ), ) ..loadHtmlString(widget.html); /// Links: a place in the document scrolls there; an http(s)/mailto address /// opens in the system's handler, never inside this view; anything else /// (scripts, files, other schemes, relative paths) stays inert. NavigationDecision _decide(NavigationRequest request) { if (!_loaded && (request.url.startsWith('about:') || request.url.startsWith('data:'))) { return NavigationDecision.navigate; } switch (artifactHtmlLinkAction(request.url)) { case ArtifactHtmlLinkAction.inDocument: return NavigationDecision.navigate; case ArtifactHtmlLinkAction.external: final uri = Uri.tryParse(request.url.trim()); if (uri != null) widget.openExternal(uri); return NavigationDecision.prevent; case ArtifactHtmlLinkAction.blocked: return NavigationDecision.prevent; } } @override void didUpdateWidget(covariant InertHtmlView oldWidget) { super.didUpdateWidget(oldWidget); if (oldWidget.html != widget.html) { _loaded = false; _controller.loadHtmlString(widget.html); } } @override Widget build(BuildContext context) => WebViewWidget( controller: _controller, gestureRecognizers: widget.interactive ? _allGestures : _inlineGestures, ); }