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 :)
Onscreen virtual keyboard for Angular using Angular Material and the Angular Virtual Keyboard by the-darc based on GreyWyvern VKI.
Checkout the demo.html
- download or clone the latest release, or use your preferred packet manager
- add the javascript and css files to your project:
<script src="angular-material-keyboard/dist/mdKeyboard.min.js"></script>
<link rel="stylesheet" href="angular-material-keyboard/dist/mdKeyboard.css">
<link rel="stylesheet" href="//fonts.googleapis.com/css?family=Material+Icons">
- register module:
'use strict';
angular
.module('myApp', [
'ngAria',
'ngAnimate',
'ngMaterial',
'material.components.keyboard'
]);
- use as attribute directive on
input
,textarea
andmd-autocomplete
<form name="myForm">
<md-input-container>
<input type="text"
use-keyboard="Deutsch"
ng-model="myModel">
</md-input-container>
</form>
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
- install node.js (I recomend to use nvm)
- get dependencies:
$ npm install && bower install
- build with gulp task:
$ gulp build