跳到主要内容

网页嵌入

概述

如果你想在 Electron 的 BrowserWindow 中嵌入(第三方)网页内容,有三种可用选项:<iframe> 标签、<webview> 标签和 WebContentsView。每种选项都提供了略微不同的功能,并在不同情况下有所用处。为了帮助你选择,本指南将解释每种选项的区别和功能。

Iframes

Electron 中的 Iframes 行为与常规浏览器中的 iframes 类似。页面中的 <iframe> 元素可以显示外部网页,前提是其内容安全策略允许。为了限制 <iframe> 标签中网站的功能数量,建议使用 sandbox 属性,并且只允许你想要支持的功能。

WebViews

信息

我们不建议你使用 WebViews,因为此标签正在经历重大的架构更改,这可能会影响你应用程序的稳定性。请考虑切换到替代方案,例如 iframe 和 Electron 的 WebContentsView,或者采用一种设计上避免嵌入内容的架构。

WebViews 基于 Chromium 的 WebViews,并且并未得到 Electron 的明确支持。我们不保证 WebView API 在 Electron 的未来版本中仍然可用。要使用 <webview> 标签,你需要在 BrowserWindowwebPreferences 中将 webviewTag 设置为 true

WebView 是一个自定义元素 (<webview>),它只在 Electron 内部工作。它们被实现为“进程外 iframe”。这意味着与 <webview> 的所有通信都通过 IPC 异步完成。<webview> 元素有许多自定义方法和事件,类似于 webContents,它们为你提供了对内容更大的控制。

<iframe> 相比,<webview> 通常略慢,但在加载和与第三方内容通信以及处理各种事件方面提供了更大的控制。

WebContentsView

WebContentsViews 不属于 DOM — 相反,它们由你的主进程创建、控制、定位和调整大小。使用 WebContentsView,你可以在同一个 BaseWindow 中组合和分层多个页面。

WebContentsViews 对其内容提供了最大的控制,因为它们实现 webContents 的方式与 BrowserWindow 类似。然而,由于 WebContentsViews 不是 DOM 内部的元素,因此相对于 DOM 内容精确地定位它们需要主进程和渲染器进程之间的协调。