The Wayback Machine - https://web.archive.org/web/20210922170036/https://www.electronjs.org/docs/latest/api/browser-view/
Skip to main content

BrowserView

A BrowserView can be used to embed additional web content into a BrowserWindow. It is like a child window, except that it is positioned relative to its owning window. It is meant to be an alternative to the webview tag.

Class: BrowserView#

Create and control views.

Process: Main

Example#

// In the main process.const { BrowserView, BrowserWindow } = require('electron')
const win = new BrowserWindow({ width: 800, height: 600 })
const view = new BrowserView()win.setBrowserView(view)view.setBounds({ x: 0, y: 0, width: 300, height: 300 })view.webContents.loadURL('https://electronjs.org')

new BrowserView([options]) Experimental#

  • options Object (optional)

Instance Properties#

Objects created with new BrowserView have the following properties:

view.webContents Experimental#

A WebContents object owned by this view.

Instance Methods#

Objects created with new BrowserView have the following instance methods:

view.setAutoResize(options) Experimental#

  • options Object
    • width Boolean (optional) - If true, the view's width will grow and shrink together with the window. false by default.
    • height Boolean (optional) - If true, the view's height will grow and shrink together with the window. false by default.
    • horizontal Boolean (optional) - If true, the view's x position and width will grow and shrink proportionally with the window. false by default.
    • vertical Boolean (optional) - If true, the view's y position and height will grow and shrink proportionally with the window. false by default.

view.setBounds(bounds) Experimental#

Resizes and moves the view to the supplied bounds relative to the window.

view.getBounds() Experimental#

Returns Rectangle

The bounds of this BrowserView instance as Object.

view.setBackgroundColor(color) Experimental#

  • color String - Color in #aarrggbb or #argb form. The alpha channel is optional.