From 29f70d7e357eae8ba18fd05ab5286951439b6fce Mon Sep 17 00:00:00 2001 From: "trop[bot]" Date: Mon, 30 Jul 2018 11:44:43 +1000 Subject: [PATCH] memo: First draft: Here be dragons (#13861) --- docs/api/webview-tag.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/api/webview-tag.md b/docs/api/webview-tag.md index 25edb6052f75..2f790e4320a1 100644 --- a/docs/api/webview-tag.md +++ b/docs/api/webview-tag.md @@ -1,5 +1,15 @@ # `` Tag +## Warning + +Electron's `webview` tag is based on [Chromium's `webview`][chrome-webview], which +is undergoing dramatic architectural changes. This impacts the stability of `webviews`, +including rendering, navigation, and event routing. We currently recommend to not +use the `webview` tag and to consider alternatives, like `iframe`, Electron's `BrowserView`, +or an architecture that avoids embedded content altogether. + +## Overview + > Display external web content in an isolated frame and process. Process: [Renderer](../glossary.md#renderer-process) @@ -914,3 +924,4 @@ Emitted when DevTools is closed. Emitted when DevTools is focused / opened. [runtime-enabled-features]: https://cs.chromium.org/chromium/src/third_party/blink/renderer/platform/runtime_enabled_features.json5?l=70 +[chrome-webview]: https://developer.chrome.com/apps/tags/webview