跳到主要内容

网页嵌入

概述

如果您想在 Electron 的 BrowserWindow 中嵌入(第三方)Web 内容,您有三个选项:<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

WebContentsView 不是 DOM 的一部分,而是由您的主进程创建、控制、定位和调整大小的。使用 WebContentsView,您可以在同一个BaseWindow中组合和分层许多页面。

WebContentsView 可以对其内容进行最大的控制,因为它们以类似于 BrowserWindow 的方式实现 webContents。但是,由于 WebContentsView 不是 DOM 内的元素,因此需要主进程和渲染进程之间的协调才能准确地相对于 DOM 内容进行定位。