Vicinae

Keyboard

Types and utilities for binding keyboard shortcuts to actions.

Keyboard.Shortcut

A shortcut is a combination of a key and one or more modifiers.

import { Action, Keyboard } from "@vicinae/api";

<Action
  title="Refresh"
  shortcut={{ key: "r", modifiers: ["cmd"] }}
  onAction={() => {}}
/>

Common Shortcuts

Use Keyboard.Shortcut.Common for standard operations. These respect user-configured keybindings.

import { Action, Keyboard } from "@vicinae/api";

<Action.CopyToClipboard
  title="Copy"
  content="🍎"
  shortcut={Keyboard.Shortcut.Common.Copy}
/>
ShortcutName
Keyboard.Shortcut.Common.CopyCopy
Keyboard.Shortcut.Common.SaveSave
Keyboard.Shortcut.Common.EditEdit
Keyboard.Shortcut.Common.NewNew
Keyboard.Shortcut.Common.OpenOpen
Keyboard.Shortcut.Common.OpenWithOpen With
Keyboard.Shortcut.Common.DuplicateDuplicate
Keyboard.Shortcut.Common.RefreshRefresh
Keyboard.Shortcut.Common.RemoveRemove
Keyboard.Shortcut.Common.RemoveAllRemove All
Keyboard.Shortcut.Common.PinPin
Keyboard.Shortcut.Common.MoveUpMove Up
Keyboard.Shortcut.Common.MoveDownMove Down
Keyboard.Shortcut.Common.CopyDeeplinkCopy Deeplink
Keyboard.Shortcut.Common.CopyNameCopy Name
Keyboard.Shortcut.Common.CopyPathCopy Path

Modifiers

ModifierKey
cmdCommand
ctrlControl
optOption / Alt
shiftShift