UWP: Rendering limitations that can occur in 3D rendering mode

For 3D WebView for UWP / Hololens, there are some scenarios in which the following limitations can occur in 3D rendering mode:

  • When a text input is focused, no blinking text caret appears
  • A webview that should have a transparent background instead has a black background

These limitations occur in 3D rendering mode in the following scenarios:

  • When running on a Hololens headset
  • Or the webview's width or height exceeds 4096 pixels
  • Or the webview's width or height exceeds the width or height of the application's window

Normally, 3D WebView renders web content using an approach that doesn't have these limitations. However, in the scenarios listed above, that rendering approach doesn't work, so 3D WebView must fall back to an alternative rendering approach that has the limitations. Starting in 3D WebView v4.7, when it falls back to the alternative rendering approach with the limitations, it logs a warning message indicating why.

If you encounter these limitations and your applicaton isn't targeting Hololens, you can avoid them with one of the following approaches:

  • By enabling Native 2D Mode
  • Or reducing the Resolution of the WebViewPrefab or CanvasWebViewPrefab so that the webview's width and height don't exceed the maximum allowed values