1. 開発者向けのウェブ技術
  2. Web API
  3. DataTransferItemList
  4. length

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

DataTransferItemList: length プロパティ

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2016年11月以降、すべてのブラウザーで利用可能です。

lengthDataTransferItemList インターフェイスの読み取り専用プロパティで、ドラッグアイテムリストの中に現在入っているアイテムの数を返します。

リスト中のドラッグデータアイテムの数で、もしリストが空か無効であれば 0 です。アイテムリストの DataTransfer オブジェクトがドラッグデータストアに関連付けられていない場合は、ドラッグアイテムリストは無効とみなされます。

この例は length プロパティの使い方を示しています。

HTML

html
<div>
 <p id="source" draggable="true">
 この要素を選択し、ドロップゾーンまでドラッグして、選択を解除すると要素が移動します。
 </p>
</div>
<div id="target">ドロップゾーン</div>

CSS

css
div {
 margin: 0em;
 padding: 2em;
}
#source {
 color: blue;
 border: 1px solid black;
}
#target {
 border: 1px solid black;
}

JavaScript

js
const source = document.getElementById("source");
const target = document.getElementById("target");
source.addEventListener("dragstart", (ev) => {
 console.log("dragStart");
 // この要素の ID をドラッグデータ本体に追加し、ドロップハンドラーが
 // どの要素をツリーに追加すべきかを認識できるようにする
 const dataList = ev.dataTransfer.items;
 dataList.add(ev.target.id, "text/plain");
 // ドラッグデータ本体に他のアイテムを追加する
 dataList.add("<p>段落...</p>", "text/html");
 dataList.add("http://www.example.org", "text/uri-list");
});
source.addEventListener("dragend", (ev) => {
 console.log("dragEnd");
 const dataList = ev.dataTransfer.items;
 // 残っているドラッグデータをすべてクリア
 dataList.clear();
});
target.addEventListener("drop", (ev) => {
 console.log("Drop");
 ev.preventDefault();
 const data = ev.dataTransfer.items;
 // ドロップされたアイテムをループ処理し、そのデータをログに記録
 for (let i = 0; i < data.length; i++) {
 if (data[i].kind === "string" && data[i].type.match("^text/plain")) {
 // アイテムがターゲットノード
 data[i].getAsString((s) => {
 ev.target.appendChild(document.getElementById(s));
 });
 } else if (data[i].kind === "string" && data[i].type.match("^text/html")) {
 // ドラッグデータ項目が HTML
 data[i].getAsString((s) => {
 console.log(`... Drop: HTML = ${s}`);
 });
 } else if (
 data[i].kind === "string" &&
 data[i].type.match("^text/uri-list")
 ) {
 // ドラッグデータ項目が URI
 data[i].getAsString((s) => {
 console.log(`... Drop: URI = ${s}`);
 });
 }
 }
});
target.addEventListener("dragover", (ev) => {
 console.log("dragOver");
 ev.preventDefault();
 // dropEffect を「移動」に設定
 ev.dataTransfer.dropEffect = "move";
});

結果

仕様書

仕様書
HTML
# dom-datatransferitemlist-length-dev

ブラウザーの互換性

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって に最終更新されました。

AltStyle によって変換されたページ (->オリジナル) /