keyboard-js

WebJar for keyboard-js

License

License

MIT
Categories

Categories

JavaScript Languages KeY Data Data Formats Formal Verification
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

keyboard-js
Last Version

Last Version

1.1.4
Release Date

Release Date

Type

Type

jar
Description

Description

keyboard-js
WebJar for keyboard-js
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/creamidea/keyboard-js

Download keyboard-js

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/keyboard-js/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>keyboard-js</artifactId>
    <version>1.1.4</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/keyboard-js/
implementation 'org.webjars.npm:keyboard-js:1.1.4'
// https://jarcasting.com/artifacts/org.webjars.npm/keyboard-js/
implementation ("org.webjars.npm:keyboard-js:1.1.4")
'org.webjars.npm:keyboard-js:jar:1.1.4'
<dependency org="org.webjars.npm" name="keyboard-js" rev="1.1.4">
  <artifact name="keyboard-js" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='keyboard-js', version='1.1.4')
)
libraryDependencies += "org.webjars.npm" % "keyboard-js" % "1.1.4"
[org.webjars.npm/keyboard-js "1.1.4"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

keyboard-js

A little library for keyboard binding. Now, it just supports chrome.

If you want to support more browsers or nodejs platform, just fork it.

Have fun, XD.

PS: Full list of key values

Usage

$ npm install keyboard-js

Try it

Now, you can try it here. (source)

And, you can find which key(key combo will print on the console.) do you press at that page, when you find your code didn't run.

Quickly start

var Keyboard = require('keyboard-js').Keyboard
var keyboard = new Keyboard() // pay more attention: singal instance

// start to listen
keyboard.start()

// register
// when you hit <kbd>Shift+e</kbd> or <kbd>Ctrl+e</kbd> that will print `> test uk successfully`.
keyboard.register('uk', function (event) {
    // event.preventDefault()
    // event.stopPropagation()
    // event.stopImmediatePropagation()

    console.log('test uk successfully.')

    // event.clearKeys() // if you use function::alert or function::confirm
}, ["Shift", "E"], ["Control", "e"]) // attention: Shift E (not e)

// have fun :)

PLEASE DO NOT USE ALERT OR CONFIRM FOR YOUR FAMILY!

Dialog boxes are modal windows - they prevent the user from accessing the rest of the program's interface until the dialog box is closed

  • Window.alert()
  • Open this and then press Ctrl + F to find This key combo keeps activating even though I'm not pressing the keys
  • If you really want to use, please don't forget to call event.clearKeys() in the callback

OMG! Please forgive me.

Attention

Please pay more attention to the key combo. You should avoid the key conflict. For example, if you registe the Shortcut Key: Shift + B, you will be confused when you hit Shift + B in the textarea. So, be careful.

However, you can use API::Keyboard.end() to end when the textarea is focused and use API::Keyboard.start() to restart when it blurs. Also, you can discard the Shortcut Key: Shift + B.

API

Constructor Options

{
    DEBUG: [boolen], // default: false. If true, it will print key message on the console.
    element: [DOM Element], // default: document. Use this to listen the keydown or keyup.
}

Exposed Interface:

Keyboard.start(): start to listen the keypress event
Keyboard.end():  end to listen keypress event and clean some resource
Keyboard.register(name:String, callback:Function, [key1:String, key2:String,...], ...): registe the keyboard binding
Keyboard.unregister(name:String): remove the register by name
Keyboard.getStatistic(): get the key pressing information

And the callback defination:

// callback
function callback (event) {
    // event.preventDefault()
    // event.stopPropagation()
    // event.stopImmediatePropagation()

    // your code here
    // ...

    // event.clearKeys() // if you use function::alert or function::confirm
}

Annexation

A keyboard layout Library (keyboard-layout.js) heatmap

Samples

You can find here

Bug

If you find bugs or have any questions, you can submit them to the github issues.

LICENSE

MIT

Versions

Version
1.1.4