Перейти к основному содержанию

BrowserView

BrowserView может использоваться для встраивания дополнительного веб-контента в BrowserWindow. Это как дочернее окно, за исключением того, что оно позиционируется относительно его владельца окна. Он предназначен для того, чтобы быть альтернативой тега webview.

Класс: BrowserView

Создание и управление видами.

Процесс: Главный

Этот модуль нельзя использовать до тех пор, пока событие ready в app не будет готово к использованию.

Пример

// В основном процессе.
const { app, BrowserView, BrowserWindow } = require('electron')

app.whenReady().then(() => {
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]) Экспериментально

  • options Object (опционально)
    • webPreferences Объект (опционально) - Смотрите BrowserWindow.

Свойства экземпляра

Объекты, созданные с помощью new BrowserView, имеют следующие свойства:

view.webContents Экспериментально

Объект WebContents, принадлежащий этому виду.

Методы экземпляра

Объекты, созданные с помощью new BrowserView, имеют следующие свойства:

view.setAutoResize(options) Экспериментально

  • options Object
    • width boolean (опционально) - если true, то ширина будет увеличиваться и уменьшаться вместе с окном. По умолчанию false.
    • height boolean (опционально) - если true, то высота будет увеличиваться и уменьшаться вместе с окном. По умолчанию false.
    • horizontal boolean (опционально) - если true, то положение по X и ширина будут увеличиваться и уменьшаться вместе с окном. По умолчанию false.
    • vertical boolean (опционально) - если true, то положение по Y и высота будут увеличиваться и уменьшаться вместе с окном. По умолчанию false.

view.setBounds(bounds) Экспериментально

Изменяет и перемещает вид в предоставленные границы относительно окна.

view.getBounds() Experimental

Возвращает Rectangle

bounds этого экземпляра BrowserView как Object.

view.setBackgroundColor(color) Экспериментально

  • color string - Color in Hex, RGB, ARGB, HSL, HSLA or named CSS color format. The alpha channel is optional for the hex type.

Examples of valid color values:

  • Hex
    • #fff (RGB)
    • #ffff (ARGB)
    • #ffffff (RRGGBB)
    • #ffffffff (AARRGGBB)
  • RGB
    • rgb(([\d]+),\s([\d]+),\s([\d]+))
      • e.g. rgb(255, 255, 255)
  • RGBA
    • rgba(([\d]+),\s([\d]+),\s([\d]+),\s*([\d.]+))
      • e.g. rgba(255, 255, 255, 1.0)
  • HSL
    • hsl((-?[\d.]+),\s([\d.]+)%,\s([\d.]+)%)
      • e.g. hsl(200, 20%, 50%)
  • HSLA
    • hsla((-?[\d.]+),\s([\d.]+)%,\s([\d.]+)%,\s*([\d.]+))
      • e.g. hsla(200, 20%, 50%, 0.5)
  • Color name
    • Options are listed in SkParseColor.cpp
    • Similar to CSS Color Module Level 3 keywords, but case-sensitive.
      • e.g. blueviolet or red

Note: Hex format with alpha takes AARRGGBB or ARGB, not RRGGBBA or RGA.