Web: use raw data in DeviceEvent::MouseMotion when using CursorGrabMode::Confined

[daxpedda]

This uses Element.requestPointerLock with the unadjustedMovement options, which is notable only supported by Chrome and even there not on Linux.

I also updated the documentation to properly reflect the current state.

Needs entry in #2875.
Fixes #3547.

[kchibisov]

I'd assume that you mean Locked pointer, which is the one that stays in place.

Also, could you change the cursor position when the cursor is locked, since it's other API that usually works with locked cursor?

And I'd assume there's no way to confine cursor at all on web?

[daxpedda]

Also, could you change the cursor position when the cursor is locked, since it's other API that usually works with locked cursor?

You can't change the cursor position on Web. What other API?
I'm not sure what you mean with that question.

And I'd assume there's no way to confine cursor at all on web?

Not AFAIK.

[kchibisov]

You can't change the cursor position on Web. What other API?
I'm not sure what you mean with that question.

Locked cursor is usually works in pair with set_cursor_position API, since otherwise it's sort of useless, unless you completely hide the cursor and draw everything yourself, which could also be an option.

On Wayland, for example, where manipulating with cursor is also prohibited, the locked pointer has its own method to set its position, but it only works when you have the cursor lock present.

It's not really mandatory, it's just changes how you write things basically.

[daxpedda]

Locked cursor is usually works in pair with set_cursor_position API, since otherwise it's sort of useless, unless you completely hide the cursor and draw everything yourself, which could also be an option.

Ah I see!
Yes, on Web the cursor is hidden, so its not a problem.
The position of the cursor remains the same as the position it was when it was locked.

Is the cursor not hidden in other backends when locked?
If not I should document this for Web.

[kchibisov]

Is the cursor not hidden in other backends when locked?
If not I should document this for Web.

it's generally not hidden and users tend to hide it themselves.

[daxpedda]

Is the cursor not hidden in other backends when locked?
If not I should document this for Web.

it's generally not hidden and users tend to hide it themselves.

Ah, CursorGrabMode::Locked already says:

There's no guarantee that the cursor will be hidden. You should hide it by yourself if you want to do so.

I removed some duplicate documentation now that I see CursorGrabMode includes it already.