keyLabel property

String get keyLabel

A description representing the character produced by a RawKeyEvent.

This value is useful for providing readable strings for keys or keyboard shortcuts. Do not use this value to compare equality of keys; compare keyId instead.

For printable keys, this is usually the printable character in upper case ignoring modifiers or combining keys, such as 'A', '1', or '/'. This might also return accented letters (such as 'Ù') for keys labeled as so, but not if such character is a result from preceding combining keys ('`̀' followed by key U).

For other keys, keyLabel looks up the full key name from a predefined map, such as 'F1', 'Shift Left', or 'Media Down'. This value is an empty string if there's no key label data for a key.

For the printable representation that takes into consideration the modifiers and combining keys, see RawKeyEvent.character.

Do not use the keyLabel to compose a text string: it will be missing special processing for Unicode strings for combining characters and other special characters, and the effects of modifiers.

If you are looking for the character produced by a key event, use RawKeyEvent.character instead.

If you are composing text strings, use the TextField or CupertinoTextField widgets, since those automatically handle many of the complexities of managing keyboard input, like showing a soft keyboard or interacting with an input method editor (IME).

Implementation

String get keyLabel {
  return _unicodeKeyLabel(keyId)
      ?? _keyLabels[keyId]
      ?? '';
}