Browse Source

docs: add notes on OOPIF webview's behaviors (#14401)

Cheng Zhao 6 years ago
parent
commit
586a6f2e6d
1 changed files with 14 additions and 0 deletions
  1. 14 0
      docs/api/webview-tag.md

+ 14 - 0
docs/api/webview-tag.md

@@ -62,6 +62,20 @@ and displays a "loading..." message during the load time:
 </script>
 ```
 
+## Internal implementation
+
+Under the hood `webview` is implemented with [Out-of-Process iframes (OOPIFs)](https://www.chromium.org/developers/design-documents/oop-iframes).
+The `webview` tag is essentially a custom element using shadow DOM to wrap an
+`iframe` element inside it.
+
+So the behavior of `webview` is very similar to a cross-domain `iframe`, as
+examples:
+
+* When clicking into a `webview`, the page focus will move from the embedder
+  frame to `webview`.
+* You can not add keyboard event listeners to `webview`.
+* All reactions between the embedder frame and `webview` are asynchronous.
+
 ## CSS Styling Notes
 
 Please note that the `webview` tag's style uses `display:flex;` internally to