ondragstartイベント

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

例

ユーザーが<p>要素のドラッグを開始したときにJavaScriptを実行します:

<p draggable="true" ondragstart="myFunction(event)">ドラッグして!</p>

試してみる »

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


定義と用法

ondragstart イベントは、ユーザーが要素または選択したテキストのドラッグを開始したときに発生します。

ドラッグ&ドロップはHTML5で非常に一般的な機能です。詳細については、HTMLチュートリアルの以下のページを参照してください。HTML5 ドラッグ&ドロップ。

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

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

ドラッグ&ドロップの過程で、以下のイベントが発生します:

  • ドラッグ対象で発生するイベント(ソース要素):
    • ondragstart - ユーザーが要素のドラッグを開始したときに発生
    • ondrag- 要素がドラッグされているときに発生
    • ondragend- ユーザーが要素のドラッグを完了したときに発生

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

ブラウザサポート

注意:要素のドラッグ中、350ミリ秒ごとに ondragover イベントが発生します。

イベント
ondragstart 4.0 9.0 3.5 6.0 12.0


構文

HTMLの場合:

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

JavaScriptの場合:

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

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

object.addEventListener("dragstart", 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 属性


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