Aller au contenu principal

Objet BrowserWindowConstructorOptions

  • width Integer (facultatif) - Largeur de la fenêtre en pixels. La valeur par défaut est 800.
  • height Integer(facultatif) - Hauteur de la fenêtre en pixels. La valeur par défaut est 600.
  • x Integer (facultatif) - (obligatoire si y est utilisé) Décalage gauche de la fenêtre à partir de l'écran. La valeur par défaut est de centrer la fenêtre.
  • y Integer (facultatif) - (obligatoire si x est utilisé) Décalage supérieur de la fenêtre par rapport à l'écran. La valeur par défaut est de centrer la fenêtre.
  • useContentSize Boolean (facultatif) - La largeur (width) et la hauteur (height) seront utilisées pour définir la taille de la page Web, ce qui signifie que la taille de la fenêtre réelle inclura la taille du cadre de celle-ci et sera légèrement plus grande. false par défaut.
  • center boolean (facultatif) - Affiche la fenêtre au centre de l’écran. false par défaut.
  • minWidth Integer (facultatif) - Largeur minimum de la fenêtre. La valeur par défaut est 0.
  • minHeight Integer (facultatif) - Hauteur minimale de la fenêtre. La valeur par défaut est 0.
  • maxWidth Integer (facultatif) - Largeur maximale de la fenêtre. Il n'y a pas de limite par défaut.
  • maxHeight Integer (facultatif) - Hauteur maximale de la fenêtre. Il n'y a pas de limite par défaut.
  • resizable boolean (optional) - Whether window is resizable. true par défaut.
  • movable boolean (optional) macOS Windows - Whether window is movable. Ceci n'est pas implémenté sous Linux. true par défaut.
  • minimizable boolean (facultatif) macOS Windows - Indique si la fenêtre est minimisable. Ceci n'est pas implémenté sous Linux. true par défaut.
  • maximizable boolean (optional) macOS Windows - Whether window is maximizable. Ceci n'est pas implémenté sous Linux. true par défaut.
  • closable boolean (optional) macOS Windows - Whether window is closable. Ceci n'est pas implémenté sous Linux. true par défaut.
  • focusable boolean (optional) - Whether the window can be focused. Default is true. On Windows setting focusable: false also implies setting skipTaskbar: true. On Linux setting focusable: false makes the window stop interacting with wm, so the window will always stay on top in all workspaces.
  • alwaysOnTop boolean (optional) - Whether the window should always stay on top of other windows. false par défaut.
  • fullscreen boolean (optional) - Whether the window should show in fullscreen. When explicitly set to false the fullscreen button will be hidden or disabled on macOS. false par défaut.
  • fullscreenable boolean (optional) - Whether the window can be put into fullscreen mode. On macOS, also whether the maximize/zoom button should toggle full screen mode or maximize window. true par défaut.
  • simpleFullscreen boolean (optional) macOS - Use pre-Lion fullscreen on macOS. false par défaut.
  • skipTaskbar boolean (optional) macOS Windows - Whether to show the window in taskbar. false par défaut.
  • hiddenInMissionControl boolean (optional) macOS - Whether window should be hidden when the user toggles into mission control.
  • kiosk boolean (optional) - Whether the window is in kiosk mode. false par défaut.
  • title string (optional) - Default window title. Default is "Electron". If the HTML tag <title> is defined in the HTML file loaded by loadURL(), this property will be ignored.
  • icon (NativeImage | string) (optional) - The window icon. On Windows it is recommended to use ICO icons to get best visual effects, you can also leave it undefined so the executable's icon will be used.
  • show boolean (optional) - Whether window should be shown when created. Default is true.
  • frame boolean (optional) - Specify false to create a frameless window. true par défaut.
  • parent BaseWindow (facultatif) - Indique la fenêtre parente. false par défaut.
  • modal boolean (facultatif) - Indique si il s'agit d'une fenêtre modale. Cela ne fonctionne que lorsque la fenêtre est une fenêtre enfant. false par défaut.
  • acceptFirstMouse boolean (facultatif) macOS - Indique si un click sur une fenêtre inactive passera à travers pour être transmis au contenu Web. La valeur par défaut est false sur macOS. Et cette option n'est pas configurable sur les autres plateformes.
  • disableAutoHideCursor boolean (facultatif) - Permet de masquer le curseur lors de la saisie. false par défaut.
  • autoHideMenuBar boolean (optional) - Auto hide the menu bar unless the Alt key is pressed. false par défaut.
  • enableLargerThanScreen boolean (optional) macOS - Enable the window to be resized larger than screen. Only relevant for macOS, as other OSes allow larger-than-screen windows by default. false par défaut.
  • backgroundColor string (optional) - The window's background color in Hex, RGB, RGBA, HSL, HSLA or named CSS color format. Alpha in #AARRGGBB format is supported if transparent is set to true. Default is #FFF (white). See win.setBackgroundColor for more information.
  • hasShadow boolean (facultatif) - Indique si la fenêtre doit avoir une ombre. true par défaut.
  • opacity number (optional) macOS Windows - Set the initial opacity of the window, between 0.0 (fully transparent) and 1.0 (fully opaque). This is only implemented on Windows and macOS.
  • darkTheme boolean (facultatif) - Force l'utilisation du thème sombre pour la fenêtre, ne fonctionne que sur certains environnements de bureau GTK+3. false par défaut.
  • transparent boolean (facultatif) - Rend la fenêtre transparent. false par défaut. Ne fonctionne pas sous Windows à moins que la fenêtre soit sans bordure.
  • type string (optional) - The type of window, default is normal window. See more about this below.
  • visualEffectState string (optional) macOS - Specify how the material appearance should reflect window activity state on macOS. Must be used with the vibrancy property. Les valeurs possibles étant:
    • followWindow - The backdrop should automatically appear active when the window is active, and inactive when it is not. C'est le comportement par défaut.
    • active - The backdrop should always appear active.
    • inactive - The backdrop should always appear inactive.
  • titleBarStyle string (optional) - The style of window title bar. Default is default. Les valeurs possibles étant:
    • default - Results in the standard title bar for macOS or Windows respectively.
    • hidden - Results in a hidden title bar and a full size content window. Sur macOS, la fenêtre aura toujours les commandes standard des fenêtres (« feux de circulation ») en haut à gauche. On Windows and Linux, when combined with titleBarOverlay: true it will activate the Window Controls Overlay (see titleBarOverlay for more information), otherwise no window controls will be shown.
    • hiddenInset macOS - Results in a hidden title bar with an alternative look where the traffic light buttons are slightly more inset from the window edge.
    • customButtonsOnHover macOS - Results in a hidden title bar and a full size content window, the traffic light buttons will display when being hovered over in the top left of the window. Note: This option is currently experimental.
  • titleBarOverlay Object | Boolean (optional) - When using a frameless window in conjunction with win.setWindowButtonVisibility(true) on macOS or using a titleBarStyle so that the standard window controls ("traffic lights" on macOS) are visible, this property enables the Window Controls Overlay JavaScript APIs and CSS Environment Variables. Specifying true will result in an overlay with default system colors. false par défaut.
    • color String (optional) Windows Linux - The CSS color of the Window Controls Overlay when enabled. La couleur par défaut est la couleur du système.
    • symbolColor String (optional) Windows - The CSS color of the symbols on the Window Controls Overlay when enabled. La couleur par défaut est la couleur du système.
    • height Integer (optional) - The height of the title bar and Window Controls Overlay in pixels. La valeur par défaut est la hauteur du système.
  • trafficLightPosition Point (optional) macOS - Set a custom position for the traffic light buttons in frameless windows.
  • roundedCorners boolean (optional) macOS - Whether frameless window should have rounded corners on macOS. true par défaut. Setting this property to false will prevent the window from being fullscreenable.
  • thickFrame boolean (optional) - Use WS_THICKFRAME style for frameless windows on Windows, which adds standard window frame. Setting it to false will remove window shadow and window animations. true par défaut.
  • vibrancy string (optional) macOS - Add a type of vibrancy effect to the window, only on macOS. Can be appearance-based, titlebar, selection, menu, popover, sidebar, header, sheet, window, hud, fullscreen-ui, tooltip, content, under-window, or under-page.
  • backgroundMaterial string (optional) Windows - Set the window's system-drawn background material, including behind the non-client area. Can be auto, none, mica, acrylic or tabbed. See win.setBackgroundMaterial for more information.
  • zoomToPageWidth boolean (optional) macOS - Controls the behavior on macOS when option-clicking the green stoplight button on the toolbar or by clicking the Window > Zoom menu item. If true, the window will grow to the preferred width of the web page when zoomed, false will cause it to zoom to the width of the screen. This will also affect the behavior when calling maximize() directly. false par défaut.
  • tabbingIdentifier string (optional) macOS - Tab group name, allows opening the window as a native tab. Windows with the same tabbing identifier will be grouped together. This also adds a native new tab button to your window's tab bar and allows your app and window to receive the new-window-for-tab event.

When setting minimum or maximum window size with minWidth/maxWidth/ minHeight/maxHeight, it only constrains the users. It won't prevent you from passing a size that does not follow size constraints to setBounds/setSize or to the constructor of BrowserWindow.

The possible values and behaviors of the type option are platform dependent. Les valeurs possibles étant:

  • Sous Linux, les types possibles sont desktop, dock, toolbar, splash, notification.
    • Le type desktop place la fenêtre au niveau de la fenêtre de fond de bureau (kCGDesktopWindowLevel - 1). However, note that a desktop window will not receive focus, keyboard, or mouse events. You can still use globalShortcut to receive input sparingly.
    • The dock type creates a dock-like window behavior.
    • The toolbar type creates a window with a toolbar appearance.
    • The splash type behaves in a specific way. It is not draggable, even if the CSS styling of the window's body contains -webkit-app-region: drag. Ce type est couramment utilisé pour les écrans de démarrage.
    • The notification type creates a window that behaves like a system notification.
  • On macOS, possible types are desktop, textured, panel.
    • The textured type adds metal gradient appearance (NSWindowStyleMaskTexturedBackground).
    • The desktop type places the window at the desktop background window level (kCGDesktopWindowLevel - 1). Note that desktop window will not receive focus, keyboard or mouse events, but you can use globalShortcut to receive input sparingly.
    • The panel type enables the window to float on top of full-screened apps by adding the NSWindowStyleMaskNonactivatingPanel style mask,normally reserved for NSPanel, at runtime. Also, the window will appear on all spaces (desktops).
  • On Windows, possible type is toolbar.