ngx-material-keyboard / angular-material-keyboard

Onscreen virtual keyboard for Angular (https://angularjs.org/) using Material (https://material.angularjs.org/) and the Angular Virtual Keyboard by the-darc (https://github.com/the-darc/angular-virtual-keyboard) based on GreyWyvern VKI (http://www.greywyvern.com/code/javascript/keyboard).
http://davidenke.github.io/angular-material-keyboard/
MIT License
15 stars 19 forks source link

Deprecated

Since Angular 2 I spend my spare time on the ngx-material-keyboard. Feel free to PR, I'll have a look at it. If you want to contribute more please message me :)

angular-material-keyboard

Onscreen virtual keyboard for Angular using Angular Material and the Angular Virtual Keyboard by the-darc based on GreyWyvern VKI.

demo

Checkout the demo.html

usage

angular .module('myApp', [ 'ngAria', 'ngAnimate', 'ngMaterial', 'material.components.keyboard' ]);

* use as attribute directive on `input`, `textarea` and `md-autocomplete`
```html
<form name="myForm">
  <md-input-container>
      <input type="text"
             use-keyboard="Deutsch"
             ng-model="myModel">
  </md-input-container>
</form>

configure

Use the mdKeyboardProvider to set your default layout or to add custom layouts:

'use strict';

angular
  .module('myApp')
  .config(function ($mdKeyboardProvider) {

    // add layout for number fields
    $mdKeyboardProvider.addLayout('Numbers', {
      'name': 'Numbers', 'keys': [
            [['7', '7'], ['8', '8'], ['9', '9'], ['Bksp', 'Bksp']],
            [['4', '4'], ['5', '5'], ['6', '6'], ['-', '-']],
            [['1', '1'], ['2', '2'], ['3', '3'], ['+', '+']],
            [['0', '0'], ['Spacer'], [','], ['Enter', 'Enter']]
      ], 'lang': ['de']
    });

    // default layout is german
    $mdKeyboardProvider.defaultLayout('Deutsch');
  });

The first entry in each 'key' array is the default char. The second is used when pressing 'shift' or 'caps lock', the third when 'alt' is rpessed. You can use the spacer key to provide a gap in the layout.

The $mdKeyboardProvider has the following methods:

getLayout(layout:string):object will give you the corresponding layout

getCurrentLayout():string will give you the current used layout

getLayouts():array returns all registered layouts

defaultLayout(layout:string):void tells the directive which layout to use as default

useLayout(layout:string):void tells the directive which layout to use

addLayout(layout:string, keys:array):void expects the name of a new layout to register along an 'keys' array

isVisible():boolean returns wether the keyboard is currently visible or not

build