AppHotkeysStore

Defined in: app-hotkeys.ts:349

Holds declared app hotkeys and the user's custom hotkeys. Framework providers create one and expose it through hooks; devtools read it from HotkeyManager.appHotkeys.

Example#

const store = new AppHotkeysStore(appHotkeys, {
  customHotkeys: JSON.parse(localStorage.getItem('hotkeys') ?? '{}'),
  onCustomHotkeysChange: (custom) =>
    localStorage.setItem('hotkeys', JSON.stringify(custom)),
})
store.setCustomHotkey('doc.save', 'Mod+Shift+S')

Type Parameters#

T#

T extends AppHotkeys = AppHotkeys

Constructors#

Constructor#

new AppHotkeysStore<T>(appHotkeys, options?): AppHotkeysStore<T>;

Defined in: app-hotkeys.ts:354

Parameters#

appHotkeys#

T

options?#

AppHotkeysStoreOptions<T> = {}

Returns#

AppHotkeysStore<T>

Properties#

store#

readonly store: Store<AppHotkeysState<T>>;

Defined in: app-hotkeys.ts:350

Accessors#

appHotkeys#

Get Signature#

get appHotkeys(): T;

Defined in: app-hotkeys.ts:372

Effective app hotkeys.

Returns#

T

customHotkeys#

Get Signature#

get customHotkeys(): CustomHotkeys<T>;

Defined in: app-hotkeys.ts:377

The user's hotkeys that differ from the defaults.

Returns#

CustomHotkeys<T>

Methods#

findConflicts()#

findConflicts(id, hotkey): AppHotkey<string, 
  | HotkeyChord
  | HotkeySequence
  | null>[];

Defined in: app-hotkeys.ts:413

Other app hotkeys that would collide if id used hotkey. App hotkeys collide when their contexts match or either has no context, and their hotkeys are equal or one sequence starts with the other.

Parameters#

id#

keyof T & string

hotkey#

Hotkey

Returns#

AppHotkey<string, | HotkeyChord | HotkeySequence | null>[]

get()#

get(id): 
  | AppHotkey<string, 
  | HotkeyChord
  | HotkeySequence
  | null>
  | undefined;

Defined in: app-hotkeys.ts:404

Effective app hotkey for an id, or undefined when it is not declared.

Parameters#

id#

string

Returns#

| AppHotkey<string, | HotkeyChord | HotkeySequence | null> | undefined

getList()#

getList(registrations): AppHotkeyListItem<T[keyof T]>[];

Defined in: app-hotkeys.ts:480

Joins app hotkeys with live registrations, in declaration order. Adapters call this with the manager's registration views.

Parameters#

registrations#

Iterable<HotkeyRegistrationView>

Returns#

AppHotkeyListItem<T[keyof T]>[]

resetCustomHotkey()#

resetCustomHotkey(id): void;

Defined in: app-hotkeys.ts:457

Restores the default hotkey for an app hotkey.

Parameters#

id#

keyof T & string

Returns#

void

resetCustomHotkeys()#

resetCustomHotkeys(): void;

Defined in: app-hotkeys.ts:464

Restores every default hotkey.

Returns#

void

setAppHotkeys()#

setAppHotkeys(appHotkeys): void;

Defined in: app-hotkeys.ts:390

Replaces the declarations, for example after hot module replacement. Custom hotkeys for ids that still exist are kept.

Parameters#

appHotkeys#

T

Returns#

void

setCustomHotkey()#

setCustomHotkey(id, hotkey): AppHotkey<string, 
  | HotkeyChord
  | HotkeySequence
  | null>[];

Defined in: app-hotkeys.ts:432

Sets the user's hotkey for an app hotkey. null unbinds it. A hotkey equal to the default removes the customization.

Parameters#

id#

keyof T & string

hotkey#

Hotkey | null

Returns#

AppHotkey<string, | HotkeyChord | HotkeySequence | null>[]

Conflicting app hotkeys. When any exist, nothing changes.

setOptions()#

setOptions(options): void;

Defined in: app-hotkeys.ts:382

Updates callbacks and other options without resetting custom hotkeys.

Parameters#

options#

Omit<AppHotkeysStoreOptions<T>, "customHotkeys">

Returns#

void