1. 開発者向けのウェブ技術
  2. Web API
  3. DataTransferItem
  4. getAsString()

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

View in English Always switch to English

DataTransferItem: getAsString() メソッド

Baseline 広く利用可能

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

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

構文

js
getAsString(callbackFn)

引数

callbackFn

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

data

DataTransferItem の文字列データです。

返値

なし (undefined)。

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

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

仕様書

仕様書
HTML
# dom-datatransferitem-getasstring-dev

ブラウザーの互換性

関連情報

MDN の改良に協力

協力方法を知る

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

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