Skip to content

Platform-specific docs about the web's CursorGrabMode #18970

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

jf908
Copy link
Contributor

@jf908 jf908 commented Apr 28, 2025

Objective

  • Document the deficiencies of CursorLockMode on the web.

Solution

Point out 4 facts about CursorLockMode::Locked on the web:

  • CursorGrabMode::Confined is unsupported
  • Cursor locking can fail
  • Doesn't emit escape key keyboard emit on unlock
  • Hides the cursor

And also points out #8949 - about how Bevy doesn't provide any mechanism for listening to grab mode state.

@ickshonpe ickshonpe added C-Docs An addition or correction to our documentation A-Windowing Platform-agnostic interface layer to run your app in S-Needs-Review Needs reviewer attention (from anyone!) to move forward labels Apr 29, 2025
@jf908 jf908 force-pushed the doc/pointer-lock-web branch from b994ac0 to dea303a Compare May 12, 2025 23:28
@janhohenheim
Copy link
Member

This documentation matches my experience with the cursor locking limitations on web pretty well

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
A-Windowing Platform-agnostic interface layer to run your app in C-Docs An addition or correction to our documentation S-Needs-Review Needs reviewer attention (from anyone!) to move forward
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants