FormatDisplayOptions

Defined in: format.ts:273

Options for formatting hotkeys for display.

Properties#

keyLabels?#

optional keyLabels?: Readonly<Record<string, string>>;

Defined in: format.ts:291

Final display overrides for logical keys or physical codes; take precedence over layoutMap. Never changes matching.

layoutMap?#

optional layoutMap?: object;

Defined in: format.ts:289

An already-resolved code-to-key map, such as KeyboardLayoutMap or Map. Used only for physical bindings. Mapped keys receive normal display formatting; missing or empty entries use conventional fallback labels. The caller owns loading and refreshing the map; this formatter never calls browser APIs.

get#

get: (code) => string | undefined;

Parameters#

code#

string

Returns#

string | undefined

parts?#

optional parts?: boolean;

Defined in: format.ts:282

Return individual key labels instead of a joined string. Default: false.

platform?#

optional platform?: HotkeyPlatform;

Defined in: format.ts:278

The target platform. Without it, formatForDisplay detects the platform in the browser and uses 'linux' on a server.

separatorToken?#

optional separatorToken?: string | null;

Defined in: format.ts:293

Override the separator between display tokens. Defaults to platform-specific formatting when null/undefined.

sequenceSeparator?#

optional sequenceSeparator?: string;

Defined in: format.ts:295

Separator between sequence steps. Default: a space.

useSymbols?#

optional useSymbols?: 
  | boolean
  | {
  keys?: boolean;
  modifiers?: boolean;
};

Defined in: format.ts:280

Whether to use symbols for the display. Defaults to true.