Keyboard Support

Contact and Search

Keyman.com Homepage

Header bottom

Keyman.com

Other versions
Version 18.0Version 17.0 (current version)Version 16.0Version 15.0Version 14.0Version 13.0Version 12.0Version 11.0Version 10.0Version 2.0

On this page

You are viewing an old version of this documentation. Click here to open the current version, 17.0.

getKeyboard

Summary

Get keyboard meta data for the selected keyboard and language.

Syntax

keyman.getKeyboard(keyboardName, languageCode)

Parameters

keyboardName
Type: string
The ID (internal name) of the keyboard.
languageCode
Type: string optional
The BCP 47 language code.

Return Value

Object
An object with metadata corresponding to the requested keyboard.

Description

The keyboard object contains the following members:

Name
string
User-friendly name of the keyboard.
InternalName
string
Internal name of the keyboard.
LanguageName
string
User-friendly name of the language actively tied to the keyboard.
LanguageCode
string
The three-letter code used to internally represent the language.
RegionName
string
The user-friendly name of the region of the world within which the language is predominantly found.
RegionCode
string
The three-letter code representing the region.
CountryName
string optional
The user-friendly name of the country in which the language is spoken.
CountryCode
string optional
A three-letter code corresponding to the country.
KeyboardID
string optional
Deprecated. A unique identifier for the keyboard. (Use 'InternalName' instead.)
Font
string optional
The font packaged with the keyboard to support its use.
OskFont
string optional
The font packaged with the keyboard to properly display specialized OSK characters.
HasLoaded
boolean
true if the keyboard has been fully loaded. false otherwise.
IsRTL
boolean optional
null whenever HasLoaded is false. Otherwise, true if the keyboard's target script is written right-to-left.

See also keyman.addKeyboards() and its documentation about keyboard specification objects.