Aller au contenu principal

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)

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

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.