3.1.0 • Published 9 months ago

ngx-touch-keyboard v3.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
9 months ago

AngularTouchKeyboard

MIT licensed npm version Build Status

What is this?

Virtual Keyboard for Angular applications.

angular touch keyboard

Demo

https://mohsen77sk.github.io/angular-touch-keyboard/

Install

Step 1: Install ngx-touch-keyboard

npm install @angular/cdk ngx-touch-keyboard

Step 2: Import the module

Add ngxTouchKeyboardModule as an import in your app's root NgModule.

import { ngxTouchKeyboardModule }  from 'ngx-touch-keyboard';
@NgModule({
  ...
  imports: [
    ...
    ngxTouchKeyboardModule,
  ],
  ...
})
export class AppModule { }

Compatibility

Version 3.0.0

  • @angular/core: ^16.0.0
  • @angular/cdk: ^16.0.0

Version 2.0.0

  • @angular/core: ^14.0.0 || ^15.0.0
  • @angular/cdk: ^14.0.0 || ^15.0.0

Localization

AngularTouchKeyboard is localized in 5 keyboard-specific locales:

  • en-US English (United States) (default)
  • en-UK English (United Kingdom)
  • fa-IR Persian (Iran)
  • sv-SE Swedish (Sweden)
  • ka-GE Georgian (Georgia)

Usage

Simple usage example

<input
  type="text"
  ngxTouchKeyboard
  #touchKeyboard="ngxTouchKeyboard"
  (focus)="touchKeyboard.openPanel()"
/>

Locale usage example

<input
  type="text"
  ngxTouchKeyboard="fa-IR"
  #touchKeyboard="ngxTouchKeyboard"
  (focus)="touchKeyboard.openPanel()"
/>

Material usage example

<mat-form-field>
  <mat-label>Default</mat-label>
  <input
    matInput
    type="text"
    ngxTouchKeyboard
    #touchKeyboard="ngxTouchKeyboard"
  />
  <button
    mat-icon-button
    matSuffix
    type="button"
    (click)="touchKeyboard.togglePanel()"
  >
    <mat-icon> keyboard </mat-icon>
  </button>
</mat-form-field>

Properties

PropertyDescription
ngxTouchKeyboardRequired to initialize Virtual Keyboard to specified input.
ngxTouchKeyboardDebugDebug mode is on.
ngxTouchKeyboardFullScreenFull screen mode is on.

Methods

Here's the list of all available methods:

MethodsDescription
openPanel(): voidOpen keyboard panel
closePanel(): voidClose keyboard panel
togglePanel(): voidToggle keyboard panel

Themes

Built-in themes

  • default: white theme
  • dark: dark theme

You must put the class dark in the body to use the dark theme.

Create custom theme

To customize the theme, you need to use css variables.

NameDescription
--tk-color-textcolor of text button
--tk-backgroundcolor of background panel
--tk-background-buttoncolor of background basic button
--tk-background-button-fncolor of background functional button
--tk-background-button-activecolor of background active button

Layouts

Depends on attribute inputmode, the keyboard layout is changed.

inputmodeScreenshot
inputmode='text'angular touch keyboard
inputmode='search'angular touch keyboard
inputmode='email'angular touch keyboard
inputmode='url'angular touch keyboard
inputmode='numeric'angular touch keyboard
inputmode='decimal'angular touch keyboard
inputmode='tel'angular touch keyboard

Development

The most useful commands for development are:

  • npm run start to start a development server
  • npm run build-demo to build the demo locally (it will be published automatically by GitHub Actions)

License

The MIT License (MIT)

3.1.0

9 months ago

3.0.0

9 months ago

2.5.0

1 year ago

2.3.2

1 year ago

2.4.0

1 year ago

2.3.1

1 year ago

2.3.0

1 year ago

2.2.0

2 years ago

2.1.0

2 years ago

2.0.2

2 years ago

2.0.1

2 years ago

2.0.0

2 years ago

1.0.2

2 years ago

1.0.1

2 years ago

1.0.0

2 years ago