input.key event

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

Event payload

{
  canvasId,
  kind: "down" | "up",
  key: KeyValue,
  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.control && event.key === 's') save();
});

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

Delivery rules

KeyValue 与 ModifierSet 使用模块页的封闭定义。失焦时终止未完成按键状态。repeat 只可能在 down 时为 true，up 固定为 false；重复频率不构成计时承诺，也不能用作高精度时钟。

Requirements

• 事件声明：input.key
• 来源：passive；只在本应用拥有焦点时送达
• 信任档位：继承 input 的 green

See also

ime、input.focus()