BrowserView

Une BrowserView peut être utilisée pour intégrer des contenus web supplémentaires dans une BrowserWindow. C'est un peu comme une fenêtre enfant, sauf qu'elle est positionnée par rapport à sa fenêtre propriétaire. Elle se veut être une alternative à la balise webview.

Classe : BrowserView

Crée et gére les vues.

Processus : Main

Ce module ne peut pas être utilisé tant que l'événement ready du module app n'est pas émis.

Exemple

// Dans le processus main.
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]) Experimental

• options Object (facultatif)
  • webPreferences Object (facultatif) - Voir BrowserWindow.

Propriétés d'instance

Les objets créés par new BrowserView possède les propriétés suivantes :

view.webContents Experimental

Un objet de type WebContents appartenant à cette vue.

Méthodes d’instance

Les objets créés par new BrowserView possèdent les méthodes d’instance suivantes :

view.setAutoResize(options) Experimental

• Objet options
  • width boolean (facultatif) - Si true, la largeur de la vue va s'agrandir et se rétrécir en même temps que la fenêtre. false par défaut.
  • height boolean (facultatif) - Si true, la hauteur de la vue va croître et se rétrécir en même temps que la fenêtre. false par défaut.
  • horizontal booléen (facultatif) - Si true, la position x et la largeur de la vue augmenteront et diminueront proportionnellement à la fenêtre. false par défaut.
  • vertical booléen (facultatif) - Si true, la position et la hauteur y de la vue augmenteront et diminueront proportionnellement à la fenêtre. false par défaut.

view.setBounds(bounds) Experimental

• bounds Rectangle

Redimensionne et déplace la vue vers les limites relatives à la fenêtre qui sont fournies .

view.getBounds() Expérimental

Retourne Rectangle

Object représentant les bounds de cette instance de BrowserView.

view.setBackgroundColor(color) Experimental

• color string - Couleur en Hex, RGB, ARGB, HSL, HSLA ou une couleur CSS nommée. Le canal alpha est facultatif pour le type hexadécimal.

Exemples de valeurs valides pour color :

• 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)
• Couleur nommée
  • Les options sont listées dans SkParseColor.cpp
  • Similaire aux mots-clés de CSS Color Module Level 3, mais sensible à la casse.
    • e.g. blueviolet or red

Note : Le format hexadécimal avec alpha s'écrit AARRGGBB ou ARGB, mais pas RRGGBBA ou RGA.