Skip to content

mixmaxhq/electron-accelerator-formatter

Repository files navigation

electron-accelerator-formatter

Formats an accelerator as a string of Unicode characters.

Handles Windows and Mac, not yet Linux.

Works in both Electron (i.e. Node) and the browser!

Installation

For Electron:

npm install electron-accelerator-formatter

or

npm install electron-accelerator-formatter --save

For the browser:

bower install electron-accelerator-formatter --save

Usage

In Electron:

var acceleratorFormatter = require('electron-accelerator-formatter');

var accelerator = 'CmdOrCtrl+Shift+M';

// Prints '⌘⇧M' on Mac, '^⇧M' on Windows
console.log(acceleratorFormatter(accelerator));

In the browser:

<!-- Loads `electronAcceleratorFormatter` into `window`. See warning below about minified version.  -->
<script src="bower_components/electron-accelerator-formatter/dist/bundle.js"></script>

<script type="text/javascript">
  var accelerator = 'CmdOrCtrl+Shift+M';

  // Prints '⌘⇧M' on Mac, '^⇧M' on Windows
  console.log(electronAcceleratorFormatter(accelerator));
</script>

Warning: there is also a minified version available, dist/bundle.min.js, but if you want to use that make sure that you are sending the UTF-8 HTTP header from your server or have added <meta charset="UTF-8"> to the page, or the formatter output will be garbled: webpack/webpack#1035.

Contributing

We welcome pull requests! Please lint your code.

Running tests

To run the Node tests: npm test.

To run the browser tests: npm run-script build-test && npm run-script open-test.

Building for release

npm run-script build

Release History

  • 1.1.1 Add bower.json file
  • 1.1.0 Works in the browser!
  • 1.0.1 Documentation fix
  • 1.0.0 Initial release.

About

Formats an Electron accelerator as a string of Unicode characters

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published