ondragoverイベント

事件对象参考手册イベントオブジェクト

例

要素がドロップターゲットにドラッグされているときにトリガーされます:

<div ondragover="myFunction(event)"></div>

試してみる »

この記事の下部には、さらに多くの例があります。


定義と使い方

ondragover イベントは、ドラッグ可能な要素または選択されたテキストがドロップターゲットにドラッグされているときにトリガーされます。

デフォルトでは、データ/要素は他の要素にドロップできません。この機能を実装するには、要素のデフォルトの処理を防ぐ必要があります。event.preventDefault() メソッドを呼び出すことで、ondragover イベントを実現できます。

ドラッグ&ドロップは HTML5 で非常に一般的な機能です。詳細は、HTML チュートリアルのHTML5 ドラッグ&ドロップ。

注意:要素をドラッグ可能にするには、HTML5 のdraggable属性を使用する必要があります。

ヒント:リンクと画像はデフォルトでドラッグ可能で、draggable 属性は必要ありません。

ドラッグ&ドロップの過程では、以下のイベントがトリガーされます:

  • ドラッグターゲット上でトリガーされるイベント(ソース要素):
    • ondragstart- ユーザーが要素のドラッグを開始したときにトリガーされます
    • ondrag- 要素がドラッグされているときにトリガーされます
    • ondragend- ユーザーが要素のドラッグを完了した後にトリガーされます

  • ドロップターゲットでトリガーされるイベント:
    • ondragenter- マウスでドラッグされたオブジェクトがそのコンテナの範囲内に入ったときにこのイベントがトリガーされます
    • ondragover - ドラッグされたオブジェクトが別のオブジェクトのコンテナ範囲内でドラッグされたときにこのイベントがトリガーされます
    • ondragleave- マウスでドラッグされたオブジェクトがそのコンテナの範囲外に出たときにこのイベントがトリガーされます
    • ondrop- ドラッグ中にマウスボタンを離したときにこのイベントがトリガーされます

注意:要素をドラッグしている間、350 ミリ秒ごとに ondragover イベントがトリガーされます。


ブラウザサポート

表内の数字は、そのイベントをサポートする最初のブラウザのバージョン番号を示しています。

イベント
ondragover 4.0 9.0 3.5 6.0 12.0


構文

HTML の場合:

<element ondragover="myScript">試してみる

JavaScript の場合:

object.ondragover=function(){myScript};試してみる

JavaScript では、addEventListener() メソッドを使用します:

object.addEventListener("dragover", myScript);試してみる

注意:Internet Explorer 8 およびそれ以前の IE バージョンはaddEventListener()メソッドをサポートしていません。


技術詳細
バブリングをサポートするか: Yes
キャンセルできるか: Yes
イベントタイプ: DragEvent
サポートされる HTML タグ: All HTML elements


Examples

その他の例

例

以下の例は、すべてのドラッグ&ドロップイベントを示しています:

/* ドラッグ時にトリガー */
document.addEventListener("dragstart", function(event) {
//dataTransfer.setData() メソッドはデータタイプとドラッグされたデータを設定します
    event.dataTransfer.setData("Text", event.target.id);
// p 要素をドラッグするときにテキストを出力します
document.getElementById("demo").innerHTML = "p 要素のドラッグを開始します.";
// ドラッグ中の要素の不透明度を変更します
    event.target.style.opacity = "0.4";
});
// p 要素をドラッグしながら、出力テキストの色を変更します
document.addEventListener("drag", function(event) {
    document.getElementById("demo").style.color = "red";
});
// p 要素のドラッグが完了したら、テキストを出力し、不透明度をリセットします
document.addEventListener("dragend", function(event) {
document.getElementById("demo").innerHTML = "p 要素のドラッグを完了しました";
    event.target.style.opacity = "1";
});
/* ドラッグ完了後にトリガー */
// p 要素がドラッグされて droptarget に入ったとき、div のボーダースタイルを変更します
document.addEventListener("dragenter", function(event) {
    if ( event.target.className == "droptarget" ) {
        event.target.style.border = "3px dotted red";
    }
});
// デフォルトでは、データ/要素は他の要素にドロップできません。drop の場合は、要素のデフォルト処理を防ぐ必要があります
document.addEventListener("dragover", function(event) {
    event.preventDefault();
});
// ドラッグ可能な p 要素が droptarget を離れたとき、div のボーダースタイルをリセットします
document.addEventListener("dragleave", function(event) {
    if ( event.target.className == "droptarget" ) {
        event.target.style.border = "";
    }
});
/* drop の場合、ブラウザのデフォルトのデータ処理を防ぎます (drop ではリンクはデフォルトで開かれます)
出力テキストの色と DIV のボーダー色をリセットします
dataTransfer.getData() メソッドを使用してドラッグ&ドロップデータを取得します
ドラッグされたデータ要素の id("drag1")
ドラッグされた要素をドロップ要素に追加します*/
document.addEventListener("drop", function(event) {
    event.preventDefault();
    if ( event.target.className == "droptarget" ) {
        document.getElementById("demo").style.color = "";
        event.target.style.border = "";
        var data = event.dataTransfer.getData("Text");
        event.target.appendChild(document.getElementById(data));
    }
});

試してみる »


関連ページ

HTML チュートリアル:HTML5 ドラッグ&ドロップ

HTML リファレンス:HTML draggable 属性


事件对象参考手册イベントオブジェクトその他の拡張