Skip to content

docs: add explanation for mouse button event modifiers #3090

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.

Sign up for GitHub

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

Merged
merged 2 commits into from
Nov 19, 2024
Merged

docs: add explanation for mouse button event modifiers #3090

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
99755ee
docs: add explanation for mouse button event modifiers
midskyey Nov 4, 2024
d4fa55f
docs: unwrap mouse button modifiers explanation out of highlighted block
midskyey Nov 19, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions src/guide/essentials/event-handling.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -357,3 +357,7 @@ The `.exact` modifier allows control of the exact combination of system modifier
- `.middle`

These modifiers restrict the handler to events triggered by a specific mouse button.

::: tip Note
`.left`, `.right`, and `.middle` modifier names are based on the typical right-handed mouse layout, but in fact represent "main", "secondary", and "auxiliary" pointing device event triggers, respectively, and not the actual physical buttons. So that for a left-handed mouse layout the "main" button might physically be the right one but would trigger the `.left` modifier handler. Or a trackpad might trigger the `.left` handler with a one-finger tap, the `.right` handler with a two-finger tap, and the `.middle` handler with a three-finger tap. Similarly, other devices and event sources generating "mouse" events might have trigger modes that are not related to "left" and "right" whatsoever.
:::