BrowserView

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

Класс: BrowserView​

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

Процесс: Основной

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

Пример​

// In the main process.
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 Объект (необязательно)
  • webPreferences Объект (необязательно) - См. BrowserWindow.

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

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

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

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

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

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

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

• options Объект
  • width логическое значение (необязательно) - Если true, ширина представления будет изменяться вместе с окном. false по умолчанию.
  • height логическое значение (необязательно) - Если true, высота представления будет изменяться вместе с окном. false по умолчанию.
  • horizontal логическое значение (необязательно) - Если true, позиция x и ширина представления будут изменяться пропорционально окну. false по умолчанию.
  • vertical логическое значение (необязательно) - Если true, позиция y и высота представления будут изменяться пропорционально окну. false по умолчанию.

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

• bounds Прямоугольник

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

view.getBounds() Экспериментальная версия​

Возвращает Прямоугольник

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

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

• color строка - Цвет в формате шестнадцатеричного кода, RGB, ARGB, HSL, HSLA или именованный CSS цвет. Альфа-канал необязателен для шестнадцатеричного формата.

Примеры допустимых значений color:

• Шестнадцатеричный
  • #fff (RGB)
  • #ffff (ARGB)
  • #ffffff (RRGGBB)
  • #ffffffff (AARRGGBB)
• RGB
  • rgb(([\d]+),\s([\d]+),\s([\d]+))
    • Например, rgb(255, 255, 255)
• RGBA
  • rgba(([\d]+),\s([\d]+),\s([\d]+),\s*([\d.]+))
    • Например, rgba(255, 255, 255, 1.0)
• HSL
  • hsl((-?[\d.]+),\s([\d.]+)%,\s([\d.]+)%)
    • Например, hsl(200, 20%, 50%)
• HSLA
  • hsla((-?[\d.]+),\s([\d.]+)%,\s([\d.]+)%,\s*([\d.]+))
    • Например, hsla(200, 20%, 50%, 0.5)
• Имя цвета
  • Варианты перечислены в SkParseColor.cpp
  • Аналогичные ключевым словам CSS Color Module Level 3, но регистрозависимые.
    • Например, blueviolet или red

Примечание: Шестнадцатеричный формат с альфа-каналом использует AARRGGBB или ARGB, а не RRGGBBA или RGA.