Skip to content

Context Menu and Menu Bar polyfill for writing NWJS compatible menus in the browser

License

Notifications You must be signed in to change notification settings

2xAA/nwjs-menu-browser

Repository files navigation

NWJS Menu Browser

Browser Polyfill for NWJS Menu and MenuItem.

Why

My audio visualisation app modV recently moved to NWJS and I had previously built my own (terrible) context menus for the browser. So as not to write two lots of code I thought I'd polyfill the browser so you could use the same code between NWJS and (presumably) Chrome!

This can also be used as a regular Context Menu library if so wished 😎

Caveats

Does not support createMacBuiltIn, MenuItem.key or MenuItem.modifiers, though usage of these will not break existing code and will be displayed in the menu nodes.

These menus are not checked against any OS menu specification, but it's close enough to polyfill for the browser. If you'd like more accurate functionality, PRs and enhancement issues are welcome!

Usage

Install

npm i nwjs-menu-browser

Demo

Run npm run watch and a browser window pointing to localhost:8080 will open. (the demo is not included in the NPM package, please clone from git)

Including in your project

The included stylesheet in dist is optional, but you will need some sort of style for your menus.

<link rel=stylesheet type=text/css href=nwjs-menu-browser.css>

ES6

import { Menu, MenuItem } from 'nwjs-menu-browser';

if(!nw) {
  var nw = {
    Menu,
    MenuItem
  };
}

ES5

if(!nw) {
  var nw = {};
  nw.Menu = require('nwjs-menu-browser').Menu;
  nw.MenuItem = require('nwjs-menu-browser').MenuItem;
}

Script Tag

<script src=nwjs-menu-browser.js></script>
<script>
if(!nw) {
  var nw = {};
  nw.Menu = window.nwjsMenuBrowser.Menu;
  nw.MenuItem = window.nwjsMenuBrowser.MenuItem;
}
</script>

Build

If required, build using npm run build, built files will be in ./dist.

Screenshots

The included stylesheet (nwjs-menu-browser.css) is a close match to macOS Sierra's menus. If somebody would like to contribute extra 'themes' I'd be very happy 😘

menu-bar

menu-bar

About

Context Menu and Menu Bar polyfill for writing NWJS compatible menus in the browser

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published