BaseWindowConstructorOptions 对象
width
Integer (可选) - 窗口的宽度,单位为像素。默认为800
。height
Integer (可选) - 窗口的高度,单位为像素。默认为600
。x
Integer (可选) - (如果使用了 y,则为必需) 窗口左侧距屏幕的偏移量。默认为窗口居中。y
Integer (可选) - (如果使用了 x,则为必需) 窗口顶部距屏幕的偏移量。默认为窗口居中。useContentSize
boolean (可选) -width
和height
将用作网页的大小,这意味着实际窗口的大小将包括窗口框架的大小,并且略大。默认为false
。center
boolean (可选) - 在屏幕中心显示窗口。默认为false
。minWidth
Integer (可选) - 窗口的最小宽度。默认为0
。minHeight
Integer (可选) - 窗口的最小高度。默认为0
。maxWidth
Integer (可选) - 窗口的最大宽度。默认为无限制。maxHeight
Integer (可选) - 窗口的最大高度。默认为无限制。resizable
boolean (可选) - 窗口是否可调整大小。默认为true
。movable
boolean (可选) macOS Windows - 窗口是否可移动。这在 Linux 上未实现。默认为true
。minimizable
boolean (可选) macOS Windows - 窗口是否可最小化。这在 Linux 上未实现。默认为true
。maximizable
boolean (可选) macOS Windows - 窗口是否可最大化。这在 Linux 上未实现。默认为true
。closable
boolean (可选) macOS Windows - 窗口是否可关闭。这在 Linux 上未实现。默认为true
。focusable
boolean (可选) - 窗口是否可以聚焦。默认为true
。在 Windows 上,设置focusable: false
也意味着设置skipTaskbar: true
。在 Linux 上,设置focusable: false
会使窗口停止与窗口管理器交互,因此窗口将始终位于所有工作区的顶部。alwaysOnTop
boolean (可选) - 窗口是否应始终位于其他窗口之上。默认为false
。fullscreen
boolean (可选) - 窗口是否应以全屏显示。当显式设置为false
时,全屏按钮将在 macOS 上隐藏或禁用。默认为false
。fullscreenable
boolean (可选) - 窗口是否可以进入全屏模式。在 macOS 上,也指最大化/缩放按钮是否应切换全屏模式或最大化窗口。默认为true
。simpleFullscreen
boolean (可选) macOS - 在 macOS 上使用 Lion 之前的全屏模式。默认为false
。skipTaskbar
boolean (可选) macOS Windows - 是否在任务栏中显示窗口。默认为false
。hiddenInMissionControl
boolean (可选) macOS - 当用户切换到调度中心时,窗口是否应隐藏。kiosk
boolean (可选) - 窗口是否处于 kiosk 模式。默认为false
。title
string (可选) - 默认窗口标题。默认为"Electron"
。如果 HTML 标记<title>
在loadURL()
加载的 HTML 文件中定义,则此属性将被忽略。icon
(NativeImage | string) (可选) - 窗口图标。在 Windows 上,建议使用ICO
图标以获得最佳视觉效果,您也可以将其保留为未定义,以便使用可执行文件的图标。show
boolean (可选) - 创建时是否应显示窗口。默认为true
。frame
boolean (可选) - 指定false
以创建无边框窗口。默认为true
。parent
BaseWindow (可选) - 指定父窗口。默认为null
。modal
boolean (可选) - 这是否是模态窗口。这仅在窗口是子窗口时有效。默认为false
。acceptFirstMouse
boolean (可选) macOS - 单击非活动窗口是否也会穿透点击到 Web 内容。在 macOS 上默认为false
。此选项在其他平台上不可配置。disableAutoHideCursor
boolean (可选) - 是否在键入时隐藏光标。默认为false
。autoHideMenuBar
boolean (可选) - 自动隐藏菜单栏,除非按下Alt
键。默认为false
。enableLargerThanScreen
boolean (可选) macOS - 允许窗口调整大小大于屏幕。仅与 macOS 相关,因为其他操作系统默认允许大于屏幕的窗口。默认为false
。backgroundColor
string (可选) - 窗口的背景颜色,采用 Hex、RGB、RGBA、HSL、HSLA 或命名的 CSS 颜色格式。如果transparent
设置为true
,则支持 #AARRGGBB 格式的 Alpha 值。默认为#FFF
(白色)。有关更多信息,请参阅 win.setBackgroundColor。hasShadow
boolean (可选) - 窗口是否应具有阴影。默认为true
。opacity
number (可选) macOS Windows - 设置窗口的初始不透明度,介于 0.0 (完全透明) 和 1.0 (完全不透明) 之间。这仅在 Windows 和 macOS 上实现。darkTheme
boolean (可选) - 强制窗口使用深色主题,仅在某些 GTK+3 桌面环境上有效。默认为false
。transparent
boolean (可选) - 使窗口透明。默认为false
。在 Windows 上,除非窗口是无边框的,否则不起作用。type
string (可选) - 窗口的类型,默认为普通窗口。请参阅下文了解更多信息。visualEffectState
string (可选) macOS - 指定在 macOS 上材质外观应如何反映窗口活动状态。必须与vibrancy
属性一起使用。可能的值为followWindow
- 当窗口处于活动状态时,背景幕应自动显示为活动状态,当窗口处于非活动状态时,背景幕应自动显示为非活动状态。这是默认值。active
- 背景幕应始终显示为活动状态。inactive
- 背景幕应始终显示为非活动状态。
titleBarStyle
string (可选) - 窗口标题栏的样式。默认为default
。可能的值为default
- 分别在 macOS 或 Windows 上产生标准标题栏。hidden
- 产生隐藏的标题栏和全尺寸内容窗口。在 macOS 上,窗口仍然在左上方具有标准窗口控件 (“交通灯”)。在 Windows 和 Linux 上,当与titleBarOverlay: true
结合使用时,它将激活窗口控件覆盖层 (有关更多信息,请参阅titleBarOverlay
),否则不会显示任何窗口控件。hiddenInset
macOS - 产生隐藏的标题栏,其替代外观是交通灯按钮从窗口边缘稍微内嵌。customButtonsOnHover
macOS - 产生隐藏的标题栏和全尺寸内容窗口,当鼠标悬停在窗口左上方时,交通灯按钮将显示。注意:此选项目前处于实验阶段。
titleBarOverlay
Object | Boolean (可选) - 在 macOS 上将无边框窗口与win.setWindowButtonVisibility(true)
结合使用,或使用titleBarStyle
以便标准窗口控件 (“macOS 上的交通灯”) 可见时,此属性启用窗口控件覆盖层 JavaScript API 和 CSS 环境变量。指定true
将导致具有默认系统颜色的覆盖层。默认为false
。color
String (可选) Windows Linux - 启用时,窗口控件覆盖层的 CSS 颜色。默认为系统颜色。symbolColor
String (可选) Windows - 启用时,窗口控件覆盖层上符号的 CSS 颜色。默认为系统颜色。height
Integer (可选) - 标题栏和窗口控件覆盖层的高度,单位为像素。默认为系统高度。
trafficLightPosition
Point (可选) macOS - 在无边框窗口中设置交通灯按钮的自定义位置。roundedCorners
boolean (可选) macOS Windows - 无边框窗口是否应具有圆角。默认为true
。将此属性设置为false
将阻止窗口在 macOS 上全屏显示。在 Windows 版本早于 Windows 11 Build 22000 的版本上,此属性无效,并且无边框窗口将不具有圆角。thickFrame
boolean (可选) - 在 Windows 上为无边框窗口使用WS_THICKFRAME
样式,这将添加标准窗口框架。将其设置为false
将删除窗口阴影和窗口动画。默认为true
。vibrancy
string (可选) macOS - 向窗口添加一种生动效果类型,仅在 macOS 上有效。可以是appearance-based
、titlebar
、selection
、menu
、popover
、sidebar
、header
、sheet
、window
、hud
、fullscreen-ui
、tooltip
、content
、under-window
或under-page
。backgroundMaterial
string (可选) Windows - 设置窗口的系统绘制的背景材质,包括非客户端区域后面的材质。可以是auto
、none
、mica
、acrylic
或tabbed
。有关更多信息,请参阅 win.setBackgroundMaterial。zoomToPageWidth
boolean (可选) macOS - 控制在 macOS 上通过 option-clicking 工具栏上的绿色停止灯按钮或单击“窗口”>“缩放”菜单项时的行为。如果为true
,则窗口将在缩放时增长到网页的首选宽度,false
将导致其缩放到屏幕的宽度。这也将影响直接调用maximize()
时的行为。默认为false
。tabbingIdentifier
string (可选) macOS - 选项卡组名称,允许将窗口作为本机选项卡打开。具有相同选项卡标识符的窗口将分组在一起。这还会向窗口的选项卡栏添加本机的新建选项卡按钮,并允许您的app
和窗口接收new-window-for-tab
事件。
当使用 minWidth
/maxWidth
/ minHeight
/maxHeight
设置最小或最大窗口大小时,它仅约束用户。它不会阻止您将不遵循大小约束的大小传递给 setBounds
/setSize
或 BrowserWindow
的构造函数。
type
选项的可能值和行为取决于平台。可能的值为
- 在 Linux 上,可能的类型为
desktop
、dock
、toolbar
、splash
、notification
。desktop
类型将窗口放置在桌面背景窗口级别 (kCGDesktopWindowLevel - 1)。但是,请注意,桌面窗口不会接收焦点、键盘或鼠标事件。您仍然可以使用 globalShortcut 来少量接收输入。dock
类型创建类似 dock 的窗口行为。toolbar
类型创建一个具有工具栏外观的窗口。splash
类型以特定方式运行。即使窗口主体的 CSS 样式包含 -webkit-app-region: drag,它也是不可拖动的。此类型通常用于启动画面。notification
类型创建一个行为类似于系统通知的窗口。
- 在 macOS 上,可能的类型为
desktop
、textured
、panel
。textured
类型添加金属渐变外观。此选项已弃用。desktop
类型将窗口放置在桌面背景窗口级别 (kCGDesktopWindowLevel - 1
)。请注意,桌面窗口不会接收焦点、键盘或鼠标事件,但您可以使用globalShortcut
来少量接收输入。panel
类型通过在运行时添加NSWindowStyleMaskNonactivatingPanel
样式掩码 (通常为 NSPanel 保留) 使窗口浮动在全屏应用程序之上。此外,窗口将出现在所有空间 (桌面) 上。
- 在 Windows 上,可能的类型为
toolbar
。