Create and control views.
Note: The BrowserView API is currently experimental and may change or be removed in future Electron releases.
Process: Main
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.
// In the main process.
const {BrowserView, BrowserWindow} = require('electron')
let win = new BrowserWindow({width: 800, height: 600})
win.on('closed', () => {
win = null
})
let view = new BrowserView({
webPreferences: {
nodeIntegration: false
}
})
win.setBrowserView(view)
view.setBounds({ x: 0, y: 0, width: 300, height: 300 })
view.webContents.loadURL('https://electron.atom.io')
new BrowserView([options])
Experimentaloptions
Object (optional)
webPreferences
Object (optional) - See BrowserWindow.BrowserView.fromId(id)
id
IntegerReturns BrowserView
- The view with the given id
.
Objects created with new BrowserView
have the following properties:
view.webContents
ExperimentalA WebContents
object owned by this view.
view.id
ExperimentalA Integer
representing the unique ID of the view.
Objects created with new BrowserView
have the following instance methods:
view.setAutoResize(options)
Experimentaloptions
Object
width
Boolean - If true
, the view’s width will grow and shrink together with the window. false
by default.height
Boolean - If true
, the view’s height will grow and shrink together with the window. false
by default.view.setBounds(bounds)
Experimentalbounds
RectangleResizes and moves the view to the supplied bounds relative to the window.
view.setBackgroundColor(color)
Experimentalcolor
String - Color in #aarrggbb
or #argb
form. The alpha channel is optional.