addKeyboardsForLanguage function
Summary
Add default or all keyboards for a given language to KeymanWeb.
Syntax
keyman.addKeyboardsForLanguage(spec[, spec...])
Parameters
spec
Type:
string
Language name string. Appending
$
to the language name will cause all available keyboards for that language to be loaded rather than the default keyboard.
Return Value
Promise
: A JavaScript Promise
fulfilled upon adding keyboards.
The promise is an array containing the following:
- successfully registered keyboard objects which define some or all of these properties
Description
The language spec is a string. Multiple language specs can also be specified in a single call, which can reduce the round-trip cost of multiple calls to Keyman Cloud servers (when using Keyman Cloud).
The first call to addKeyboardsForLanguage()
makes an additional call to the Keyman API to load the current list of keyboard/language associations. This determines the default keyboards that are added for the language.
For general information and example uses of this method, please see the Adding Keyboards page from the guide section.
Using a string
For the given language specs, the Keyman Cloud is used to source the keyboard file.