DataTransferItem

Baseline 廣泛可用 *

此功能已得到良好確立,並在許多裝置和瀏覽器版本中都可使用。自 ⁨2016 年 11 月⁩以來,它已在所有瀏覽器中可用。

* 此特性的某些部分可能存在不同級別的支援。

DataTransferItem 物件代表一個拖放的資料項。在拖放操作期間,每個 DragEvent 都有一個 dataTransfer 屬性,其中包含一個拖放資料項的列表。列表中的每一項都是一個 DataTransferItem 物件。

DataTransferItem 最初是為 HTML 拖放 API 設計的,並且仍然在 HTML 拖放部分進行規範說明,但現在也被其他 API 使用,例如 ClipboardEvent.clipboardDataInputEvent.dataTransferDataTransferItem 的文件主要討論其在拖放操作中的用法,您應該參考其他 API 的文件以瞭解 DataTransferItem 在這些上下文中的用法。

此介面沒有建構函式。

例項屬性

DataTransferItem.kind 只讀

拖放資料項的型別,為 stringfile

DataTransferItem.type 只讀

拖放資料項的型別,通常是 MIME 型別。

例項方法

DataTransferItem.getAsFile()

返回與拖放資料項關聯的 File 物件(如果拖放項不是檔案,則返回 null)。

DataTransferItem.getAsFileSystemHandle() 實驗性

返回一個 Promise,如果拖放項是檔案,則解析為 FileSystemFileHandle;如果拖放項是目錄,則解析為 FileSystemDirectoryHandle

DataTransferItem.getAsString()

使用指定的字串作為拖放資料項的引數呼叫該回調函式。

DataTransferItem.webkitGetAsEntry()

返回一個基於 FileSystemEntry 的物件,表示所選檔案在其檔案系統中的條目。這通常是 FileSystemFileEntryFileSystemDirectoryEntry 物件。

示例

此介面的所有方法和屬性都有自己的參考頁面,並且每個參考頁面都有使用示例。

規範

規範
HTML
# the-datatransferitem-interface

瀏覽器相容性