input.key event

表示本应用拥有焦点时的按键按下或抬起。用于快捷键和控制键；文本输入应使用 ime。

Event payload

{
  canvasId,
  kind: "down" | "up",
  key: bounded-string,
  code: bounded-string,
  repeat: boolean,
  modifiers: ModifierSet
}

Examples

host.events.on('input.key', (event) => {
  if (event.kind === 'down' && event.key === 'Escape') closeDialog();
  if (event.kind === 'down' && event.modifiers.ctrl && event.key === 's') save();
});

宿主保留的系统快捷键、密码管理器输入和其他应用按键不得送达。

Delivery rules

失焦时终止未完成按键状态。repeat 由宿主规范化，不能用重复频率作为高精度时钟。

See also

ime、input.focus()