From bb44959811dc6496e79159ae72c24c6996c80566 Mon Sep 17 00:00:00 2001
From: Jun Shindo <46585162+jay-es@users.noreply.github.com>
Date: Fri, 22 Nov 2024 21:50:18 +0900
Subject: [PATCH] docs: add explanation for mouse button event modifiers

---
 src/guide/essentials/event-handling.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/guide/essentials/event-handling.md b/src/guide/essentials/event-handling.md
index b0938e994..d6fa0565a 100644
--- a/src/guide/essentials/event-handling.md
+++ b/src/guide/essentials/event-handling.md
@@ -357,3 +357,5 @@ Mac キーボードでは、メタキーはコマンドキー（⌘）が使わ
 - `.middle`
 
 これらの修飾子は特定のマウスボタンが発火したイベントを制御するハンドラーを制限します。
+
+ただし、`.left`、`.right`、および `.middle` 修飾子名は、一般的な右利き用マウスのレイアウトに基づいていることに注意してください。しかし、実際にはそれぞれ「メイン」、「セカンダリ」、および「補助」のポインティングデバイスのイベントトリガーを表しており、実際の物理ボタンを表しているわけではありません。そのため、左利き用マウスのレイアウトでは、「メイン」ボタンが物理的には右ボタンであっても、`.left` 修飾子ハンドラがトリガーされる可能性があります。あるいはトラックパッドでは、1 本指タップで `.left` ハンドラーが、2 本指タップで `.right` ハンドラーが、3 本指タップで `.middle` ハンドラがトリガーされるかもしれません。同様に、「マウス」イベントを生成する他のデバイスやイベントソースでは、「左」や「右」とはまったく関係のないトリガーモードが存在するかもしれません。