このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
Element: dblclick イベント
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
dblclick イベントは、ポインティングデバイスのボタン(マウスの第一ボタンなど)がダブルクリックされたとき、つまり、単一の要素上でとても短い時間内に素早く 2 回クリックされたときに発行されます。
dblclick は 2 回のclick イベントの後 (展開すると、2 組のmousedown およびmouseup の後) に発生します。
In this article
構文
このイベント名をaddEventListener() 等のメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。
addEventListener("dblclick", (event) => {});ondblclick = (event) => {};イベント型
MouseEvent です。UIEvent およびEvent を継承しています。
イベントプロパティ
親であるUIEvent およびEvent から継承したプロパティもあります。
MouseEvent.altKey読取専用このマウスイベントが発行されたときにalt キーが押されていた場合は
trueを返します。MouseEvent.button読取専用このマウスイベントが発行されたときに押されていたボタンの番号です(もしあれば)。
MouseEvent.buttons読取専用このマウスイベントが発行されたときに押されていたボタンです(もしあれば)。
MouseEvent.clientX読取専用ビューポート座標におけるマウスポインターの X 座標です。
MouseEvent.clientY読取専用ビューポート座標におけるマウスポインターの Y 座標です。
MouseEvent.ctrlKey読取専用このマウスイベントが発行されたときにcontrol キーが押されていた場合は
trueを返します。MouseEvent.layerX非標準読取専用このイベントの現在のレイヤーにおける相対の水平座標を返します。
MouseEvent.layerY非標準読取専用このイベントの現在のレイヤーにおける相対の垂直座標を返します。
MouseEvent.metaKey読取専用このマウスイベントが発行されたときにmeta キーが押されていた場合は
trueを返します。MouseEvent.movementX読取専用前回の
mousemoveイベントの位置から相対的なマウスポインターの X 座標です。MouseEvent.movementY読取専用前回の
mousemoveイベントの位置から相対的なマウスポインターの Y 座標です。MouseEvent.offsetX読取専用対象ノードのパディング辺からの相対的なマウスポインターの X 座標です。
MouseEvent.offsetY読取専用対象ノードのパディング辺からの相対的なマウスポインターの Y 座標です。
MouseEvent.pageX読取専用文書全体からの相対的なマウスポインターの X 座標です。
MouseEvent.pageY読取専用文書全体からの相対的なマウスポインターの Y 座標です。
MouseEvent.relatedTarget読取専用もしあれば、イベントの副ターゲットです。
MouseEvent.screenX読取専用スクリーン座標におけるマウスポインターの X 座標です。
MouseEvent.screenY読取専用スクリーン座標におけるマウスポインターの Y 座標です。
MouseEvent.shiftKey読取専用このマウスイベントが発行されたときにshift キーが押されていた場合は
trueを返します。MouseEvent.mozInputSource非標準読取専用イベントを発生させた機器の種類(
MOZ_SOURCE_*定数のいずれか)。これにより、例えばマウスイベントが実際のマウスによって生成されたのか、タッチイベントによって生成されたのかを判断することができます(これはイベントに関連付けられた座標を解釈する精度に影響するかもしれません)。MouseEvent.webkitForce非標準読取専用クリックしたときに適用された圧力です。
MouseEvent.x読取専用MouseEvent.clientXの別名です。MouseEvent.y読取専用MouseEvent.clientYの別名です。
例
この例では、カードをダブルクリックするたびに寸法が切り替わります。
JavaScript
const card = document.querySelector("aside");card.addEventListener("dblclick", (e) => { card.classList.toggle("large");});HTML
<aside> <h3>カード</h3> <p>ダブルクリックするとこのオブジェクトをリサイズします。</p></aside>CSS
aside { background: #fe9; border-radius: 1em; display: inline-block; padding: 1em; transform: scale(0.9); transform-origin: 0 0; transition: transform 0.6s; user-select: none;}.large { transform: scale(1.3);}結果
仕様書
| Specification |
|---|
| UI Events> # event-type-dblclick> |
| HTML> # handler-ondblclick> |