DataTransfer: thuộc tính dropEffect

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.

Thuộc tính DataTransfer.dropEffect điều khiển phản hồi (thường là trực quan) được cung cấp cho người dùng trong thao tác kéo và thả. Nó ảnh hưởng đến con trỏ hiển thị trong khi kéo. Ví dụ, khi người dùng di chuột qua phần tử đích thả, con trỏ của trình duyệt có thể cho biết loại thao tác nào sẽ xảy ra.

Khi đối tượng DataTransfer được tạo, dropEffect được đặt thành một giá trị chuỗi. Khi lấy, nó trả về giá trị hiện tại. Khi đặt, nếu giá trị mới là một trong các giá trị được liệt kê bên dưới, thì giá trị hiện tại của thuộc tính sẽ được đặt thành giá trị mới và các giá trị khác sẽ bị bỏ qua.

Đối với các sự kiện dragenter và dragover, dropEffect sẽ được khởi tạo dựa trên hành động mà người dùng yêu cầu. Cách xác định điều này phụ thuộc vào nền tảng, nhưng thông thường người dùng có thể nhấn các phím bổ trợ như phím alt để điều chỉnh hành động mong muốn. Trong các trình xử lý sự kiện cho dragenter và dragover, dropEffect nên được sửa đổi nếu muốn một hành động khác với hành động người dùng yêu cầu.

Đối với các sự kiện drop và dragend, dropEffect sẽ được đặt thành hành động mong muốn, tức là giá trị mà dropEffect có sau sự kiện dragenter hoặc dragover cuối cùng. Ví dụ trong sự kiện dragend, nếu dropEffect mong muốn là "move", thì dữ liệu đang được kéo sẽ bị xóa khỏi nguồn.