Feature: Add built-in preventDefault for wheel and contextmenu events on canvas

Aperta
#3,062 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
35/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
typescript
Ambito
game-dev

Direzione di ricerca

The payload names no source files. Start by finding where the engine attaches input listeners to the canvas and where engine.destroy() tears them down, then compare with the Babylon.js attachControl/detachControl pattern cited in the issue. Agree the opt-in/opt-out API shape with the maintainers before coding. Done means wheel and contextmenu default behavior can be disabled and re-enabled, and all listeners are removed on destroy.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Is your feature request related to a problem? Please describe.

目前在 Galacean 中使用相机控制或其他需要与 canvas 交互的功能时,wheel 事件会同时触发页面滚动,contextmenu 事件会弹出浏览器的右键菜单。这两个默认行为在 3D 场景交互中通常是预期之外的:

  • wheel 事件:用户滚轮时,期望的是相机缩放/移动,而不是页面上下滚动
  • contextmenu 事件:用户右键拖拽旋转场景时,期望的是旋转操作,而不是弹出浏览器右键菜单

目前用户需要手动在 canvas 上自行添加事件监听来调用 preventDefault(),这不仅繁琐,而且容易忘记在组件销毁时清理监听器,造成内存泄漏。

Describe the solution you'd like

参考 Babylon.js 的设计,建议在引擎/画布层面提供以下能力:

  1. 为 canvas 提供一个统一的 wheel 和 contextmenu 事件 preventDefault 开关,同时允许用户显式关闭,可以按需控制。

  2. 做好生命周期管理:事件的注册与移除应与引擎/场景的生命周期绑定(如在 engine.destroy() 或相应生命周期钩子中自动解绑),避免内存泄漏。

Describe alternatives you've considered

  1. 不做任何改动,让用户自行处理:但这会增加每个使用者的心智负担,且容易忽略生命周期清理。3D 引擎的用户通常期望引擎已经处理好这些常见的 UX 问题。

  2. 仅在具体的相机控制组件中处理:但这样不够通用,如果用户使用自定义的交互逻辑(而非内置相机控制器),仍然需要自行处理。

Additional context

  • Babylon.js 的参考实现:
    • Wheel 事件:BaseCameraMouseWheelInput.attachControl(noPreventDefault?) — 默认 preventDefault,可通过参数关闭
    • ContextMenu 事件:BaseCameraPointersInput / FreeCameraMouseInput — 直接在 canvas 上注册 contextmenu 监听,默认 preventDefault,onContextMenu 方法可被 override
    • 两者都在 detachControl() 中正确清理事件监听器
Lingua principale
TypeScript
Stelle
5.9k
Fork
413
Merge medio
16h 17m
PR unite (30g)
41

Preparare l'ambiente

  • Nessun Dockerfile né file Docker Compose
  • Ha un modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di galacean/engine

Tutte le issue di galacean/engine

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.