input.wheel event

表示用户在应用绘图面上的二维滚动意图。宿主把平台差异规范化为逻辑像素增量。

Event payload

{ canvasId, x: f32, y: f32, deltaX: f32, deltaY: f32, modifiers: ModifierSet }

Examples

host.events.on('input.wheel', ({ deltaX, deltaY }) => {
  viewport.scrollBy(deltaX, deltaY);
});

Delivery rules

高频事件可以合并；deltaX/deltaY 分别是被合并样本的代数和，x/y 取最后一个样本的位置。若相加不能保持有限值，宿主必须拆分事件而不是钳制。所有字段必须有限。

Requirements

• 事件声明：input.wheel
• 来源：passive；只在指针位于本应用绘图面、应用可见且该绘图面拥有焦点时送达
• 信任档位：继承 input 的 green

See also

input.pointer、input.focus()