DataTransferItem
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since November 2016.
* Some parts of this feature may have varying levels of support.
Đối tượng DataTransferItem đại diện cho một mục dữ liệu kéo. Trong một thao tác kéo, mỗi DragEvent có một thuộc tính dataTransfer chứa một danh sách các mục dữ liệu kéo. Mỗi mục trong danh sách là một đối tượng DataTransferItem.
DataTransferItem được thiết kế chủ yếu cho HTML Drag and Drop API, và vẫn được đặc tả trong phần kéo và thả HTML, nhưng hiện nay cũng được sử dụng bởi các API khác, chẳng hạn như ClipboardEvent.clipboardData và InputEvent.dataTransfer. Tài liệu về DataTransferItem chủ yếu thảo luận về việc sử dụng trong các thao tác kéo và thả, và bạn nên tham khảo tài liệu của các API khác để biết cách sử dụng DataTransferItem trong các ngữ cảnh đó.
Giao diện này không có hàm khởi tạo.
Thuộc tính phiên bản
DataTransferItem.kindRead only-
Loại của mục dữ liệu kéo,
stringhoặcfile. DataTransferItem.typeRead only-
Kiểu của mục dữ liệu kéo, thường là một kiểu MIME.
Phương thức phiên bản
DataTransferItem.getAsFile()-
Trả về đối tượng
Fileliên kết với mục dữ liệu kéo (hoặc null nếu mục kéo không phải là tệp). DataTransferItem.getAsFileSystemHandle()Experimental-
Trả về một
Promisehoàn thành vớiFileSystemFileHandlenếu mục được kéo là tệp, hoặc hoàn thành vớiFileSystemDirectoryHandlenếu mục được kéo là thư mục. DataTransferItem.getAsString()-
Gọi hàm callback đã chỉ định với chuỗi dữ liệu của mục kéo làm đối số.
DataTransferItem.webkitGetAsEntry()-
Trả về một đối tượng dựa trên
FileSystemEntryđại diện cho mục nhập của tệp được chọn trong hệ thống tệp của nó. Thường là đối tượngFileSystemFileEntryhoặcFileSystemDirectoryEntry.
Ví dụ
Tất cả các phương thức và thuộc tính của giao diện này đều có trang tham chiếu riêng, và mỗi trang tham chiếu có ví dụ về cách sử dụng.
Thông số kỹ thuật
| Specification |
|---|
| HTML # the-datatransferitem-interface |