Skip to content

platform/electron/overlay

Defined in: app/src/platform/electron/overlay.ts:32

A transparent view above the tabs of a window, for popovers and prompts that must cover web content, which lies above the shell. The view is made when it is first needed and is part of the window only while it shows something, because a view takes the clicks and the focus of what lies below it. A click next to the popover, Escape, a shortcut, a change of the window’s size or of its visible tab closes it, and the focus goes back to the page.

new WindowOverlay(window, options): WindowOverlay

Defined in: app/src/platform/electron/overlay.ts:44

BrowserWindowController

The window that the overlay covers.

OverlayOptions

What the overlays of all windows share.

WindowOverlay

get content(): OverlayContent | null

Defined in: app/src/platform/electron/overlay.ts:50

What the overlay shows, or null while it is closed.

OverlayContent | null

get contents(): WebContents | undefined

Defined in: app/src/platform/electron/overlay.ts:55

The page of the overlay, once it exists.

WebContents | undefined

close(): void

Defined in: app/src/platform/electron/overlay.ts:92

Closes the overlay and gives the focus back to the page or the shell.

void

OverlayHandle.close

open(content, onClose?): void

Defined in: app/src/platform/electron/overlay.ts:65

Shows content above the window’s tabs, or replaces what it shows.

OverlayContent

What to show.

() => void

Called once when the content closes or is replaced, such as to cancel what it asked for.

void

update(content): void

Defined in: app/src/platform/electron/overlay.ts:85

Changes what an open overlay shows, without taking the focus.

OverlayContent

What to show.

void

Defined in: app/src/platform/electron/overlay.ts:10

What the overlays of all windows share.

readonly appearanceArgument: () => string

Defined in: app/src/platform/electron/overlay.ts:18

Command line argument that gives the page its design tokens.

string

readonly gate: IpcGate

Defined in: app/src/platform/electron/overlay.ts:21

readonly languageArguments: readonly string[]

Defined in: app/src/platform/electron/overlay.ts:20

Command line arguments that give the page its language.

readonly partition: string

Defined in: app/src/platform/electron/overlay.ts:16

Partition of the browser’s own views.

readonly preload: string

Defined in: app/src/platform/electron/overlay.ts:14

Path of the preload script of the browser’s own pages.

readonly router: IpcRouter

Defined in: app/src/platform/electron/overlay.ts:22

readonly url: string

Defined in: app/src/platform/electron/overlay.ts:12

URL of the overlay page, normally app://overlay/.