Summary
The current documentation page docs.flutter.dev/platform-integration/web/web-content-in-flutter introduces HtmlElementView and package:webview_flutter, but does not cover package:pointer_interceptor or DOM slot layering.
Proposed Additions
package:pointer_interceptor Guidance: HtmlElementView and platform view nodes swallow mouse and touch pointer events on the web because <flt-platform-view-slot> uses pointer-events: auto inside <flt-scene-host>, blocking Flutter widgets (buttons, drawers, menus, dialogs) positioned on top of them from receiving taps. Add clear usage documentation and code samples for PointerInterceptor.- DOM Slot Layering: Explain how Flutter web mounts platform views as
<slot> elements in the shadow DOM tree (<flt-scene-host> / <flt-platform-view-slot>) and how z-index and pointer-event passthrough operate between WebGL canvas layers and platform view DOM nodes.
Related framework issues: flutter/flutter#123343
Summary
The current documentation page
docs.flutter.dev/platform-integration/web/web-content-in-flutterintroducesHtmlElementViewandpackage:webview_flutter, but does not coverpackage:pointer_interceptoror DOM slot layering.Proposed Additions
package:pointer_interceptorGuidance:HtmlElementViewand platform view nodes swallow mouse and touch pointer events on the web because<flt-platform-view-slot>usespointer-events: autoinside<flt-scene-host>, blocking Flutter widgets (buttons, drawers, menus, dialogs) positioned on top of them from receiving taps. Add clear usage documentation and code samples forPointerInterceptor.<slot>elements in the shadow DOM tree (<flt-scene-host>/<flt-platform-view-slot>) and how z-index and pointer-event passthrough operate between WebGL canvas layers and platform view DOM nodes.Related framework issues: flutter/flutter#123343