Skip to content

aurelia-contrib/aurelia-combo

Repository files navigation

aurelia-combo CI

An Aurelia plugin for easy keyboard combo short-cuts.

Install Package

npm i aurelia-combo or yarn add aurelia-combo

Usage

In your main.js file

aurelia.use.plugin(PLATFORM.moduleName('aurelia-combo'));

It uses keymaster underneath to support keyboard short-cut. Read it to understand the supported short-cut format.

aurelia-combo has an embedded keymaster which contains unpublished fixes and additional fix on removing registered event handlers.

Note @combo decorator injects piece of code into two Aurelia life-cycle callbacks: attached and detached. This means @combo only works on Aurelia custom elements or components. It doesn't work on generic JavaScript classes which has no attached/detached callbacks.

import {combo} from 'aurelia-combo';
export class MyVm {
  @combo('ctrl+f', 'command+f') // array of short-cuts
  findIt(e) {
    console.log('findIt');
  }

  @combo('ctrl+c, command+c') // or a string of all, keymaster understands
  copyIt(e) {
    console.log('copyIt');
  }
}

Take findIt as example, the above code is very similar to what you do manually:

import key from 'keymaster';
export class MyVm {
  attached() {
    key('ctrl+f, command+f', e => {
      // By default, preventDefault will be called for the keyboard event.
      // User can skip the behavior by returning true from the decorated method.
      if (true !== this.findIt(e)) e.preventDefault();
    })
  }

  detached() {
    key.unbind('ctrl+f, command+f')
  }

  findIt(e) {
    console.log('findIt');
  }
}

Inside input, select or textarea

By default, keymaster ignores all keyboard events originating from <input>, <select>, and <textarea> elements. To enable short-cuts from <input> and the other two elements, pass in an optional boolean option to enable it.

// pass true at the end of arguments,
// to enable ctrl+f inside <input>.
@combo('ctrl+f', 'command+f', true)

// pass true at the end of arguments.
@combo('ctrl+c, command+c', true)

License

MIT.

About

An Aurelia plugin for easy keyboard combo short-cuts

Resources

License

Stars

Watchers

Forks

Packages

No packages published