DataTransferItem.getAsString()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

DataTransferItem.getAsString() メソッドは、項目の kind が プレーン Unicode 文字列 （すなわち kind が string）である場合に、ドラッグデータ項目の文字列データを引数に指定してコールバックを呼び出すメソッドです。

構文

js
// アロー関数
getAsString((data) => { /* … */ } )

// コールバック関数
getAsString(callbackFn)

// インラインコールバック関数
getAsString(function(data) { /* … */ })

引数

callbackFn

以下の引数を受け取るコールバック関数です。

data

データ転送アイテムの文字列データです。

返値

なし (undefined)。

例

この例では、 drop イベントハンドラーにおいて、 getAsString() メソッドを インライン関数 として使用しているところを示しています。

js
function drop_handler(ev) {
  console.log("Drop");
  ev.preventDefault();
  const data = ev.dataTransfer.items;
  for (let i = 0; i < data.length; i += 1) {
    if (data[i].kind === "string" && data[i].type.match("^text/plain")) {
      // This item is the target node
      data[i].getAsString((s) => {
        ev.target.appendChild(document.getElementById(s));
      });
    } else if (data[i].kind === "string" && data[i].type.match("^text/html")) {
      // Drag data item is HTML
      console.log("… Drop: HTML");
    } else if (
      data[i].kind === "string" &&
      data[i].type.match("^text/uri-list")
    ) {
      // Drag data item is URI
      console.log("… Drop: URI");
    } else if (data[i].kind === "file" && data[i].type.match("^image/")) {
      // Drag data item is an image file
      const f = data[i].getAsFile();
      console.log("… Drop: File ");
    }
  }
}

仕様書

Specification
HTML Standard
# dom-datatransferitem-getasstring-dev

ブラウザーの互換性

BCD tables only load in the browser

関連情報