goabstract/electron-panel-window

electron-panel-window

Enables creating a browser window in Electron that behaves like a Panel. Panels are typically used for auxillary windows and do not activate the application – as such they can appear ontop of other apps in the same way as Spotlight or 1Password, for example.

Usage

Use PanelWindow as you would BrowserWindow. All of the methods exposed in this module must be used on the main process. Using the methods in a renderer process will result in your app crashing.

import { PanelWindow } from 'electron-panel-window';

const win = new PanelWindow({
  width: 800,
  height: 600,
  show: false
})

// the window will show without activating the application
win.show();

You can also access the utility methods directly:

import { remote } from 'electron';
import { makePanel, makeKeyWindow } from 'electron-panel-window';

const currentWindow = remote.getCurrentWindow();

// convert the window to an NSPanel
makePanel(currentWindow);

// focus the window without activating the application
makeKeyWindow(currentWindow);

Development

To compile the extension for the first time, run

$ yarn
$ yarn configure
$ yarn build

All subsequent builds only need yarn build. Tests run in Spectron:

$ yarn test

Contributing

This project is maintained by Abstract. We are very willing to accept contributions, first please ensure there is a relavant issue in the tracker and an approach has been discussed before beginning to write code – this makes it more likely we will be able to accept your contribution and ensure nobody's time (especially yours!) is wasted.

Details

License

This project is under MIT. See LICENSE