aria-dropeffect

全局 aria-dropeffect 属性指示在将拖动对象释放到放置目标时可以执行哪些功能。

描述

aria-dropeffect 属性在 ARIA 1.1 中已弃用，它指示在将拖动对象释放到放置目标时可以执行哪些功能。全局 aria-dropeffect 属性为辅助技术用户提供了与通过 DataTransfer.dropEffect 提供给站点用户相同的 dropEffect 图标信息。

默认情况下，文本选择、图像和链接可以被拖动。设置全局 draggable="true" 属性（HTML5 的 拖放 API 的一部分）以及 dragstart 事件处理程序，意味着任何 DOM 节点都可以被拖动。

当拖动事件发生时，会生成拖动元素的半透明图像，该图像在拖动过程中跟随用户的指针。可以使用 setDragImage 将默认图像更改为任何图像。除了用于标识正在拖动元素的默认图像之外，还有一个 dataTransfer.dropEffect 属性，可用于控制拖放操作期间提供给用户的视觉反馈。应使用 aria-dropeffect 属性为辅助技术用户提供与通过 dataTransfer.dropEffect 属性提供给站点用户的相同反馈。

dropeffect 定义了浏览器在拖动过程中显示的游标，并设置在元素可以放置其上的元素上。在拖动操作期间，当可拖动元素拖放到不同的放置区域时，应修改拖放效果（dataTransfer.dropeffect 和 aria-dropeffect）以指示如果释放拖动元素将执行的操作类型。

对于给定元素，可能支持多个拖放效果。因此，aria-dropeffect 属性的值是函数的空格分隔列表。函数包括 copy、execute、link 和 move。默认值为 none，这意味着应用程序中没有支持的功能。设置 aria-dropeffect="popup" 会通知辅助技术用户存在一个弹出菜单或拖动操作的对话框，用户可以从中选择。

包含属性可以让辅助技术能够向辅助技术用户传达可用的拖动选项，但不会添加任何实际功能。

aria-dropeffect 属性预计将在 WAI-ARIA 的未来版本中被新功能取代，并且被视为已弃用。

通常，只有在对象被抓住用于拖动操作之后才能提供拖放效果功能，因为可用的拖放效果功能取决于正在拖动的对象。因此，您通常会在触发 dragstart 事件时，将 aria-dropeffect 添加到所有潜在的放置目标。

值

该值是一个空格分隔的可能操作列表。以下是有效的标记

copy

源对象的副本将被放置到目标中。

execute

放置目标支持的功能将执行，使用拖动源作为输入。

将在目标对象中创建对拖动对象的引用或快捷方式。

move

源对象将从其当前位置移除并放置到目标中。

none（默认）

无法执行任何操作；如果尝试将对象放置到此对象上，则实际上会取消拖动操作。如果与任何其他标记值组合，则将被忽略；例如，'none copy' 等效于 'copy' 值。

存在一个弹出菜单或对话框，允许用户选择一个拖动操作（copy、move、link、execute）以及任何其他拖动功能，例如取消。

关联角色

在 **所有** 角色中使用。

规范

规范
可访问的富互联网应用程序 (WAI-ARIA)
# aria-dropeffect

另请参阅