spiegel-keyman/web/docs/engine/reference/core/getActiveLanguage.md
Marc Durdin 1f82507730 docs(web): deprecate unused and obsolete API endpoints and docs cleanup
Deprecate the following obsolete functions and properties:
* `keyman.helpURL`
* `keyman.util.rgba`
* `keyman.util.toFloat`
* `keyman.util.toNumber`
* `keyman.util.toNzString`

Use correct language for code blocks in Keyman Engine for Web
documentation.

Test-bot: skip
2026-08-12 16:07:22 +02:00

781 B

title
getActiveLanguage

Summary

Get the language tag or name for the currently selected language for the active keyboard.

Syntax

keyman.getActiveLanguage(fullName)

Parameters

fullName
Type: boolean optional
If true, return the language name

Return Value

string
The active language's BCP 47 language tag or name.

Description

The BCP 47 language tag returned relates to the currently active registered keyboard. If no keyboard is active, the return value will be an empty string.

The language tag may be any well-formed BCP 47 language tag.

The language name is also derived from the keyboard registration, so may not match language names from Intl or other sources.