ARIA：aria-dropeffect 属性

描述

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

默认情况下，文本选择、图像和链接是可以拖动的。通过设置 HTML5 的 拖放 API 的全局 draggable="true" 属性，并使用 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

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

执行

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

link

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

move

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

none（默认）

无法执行任何操作；如果尝试将对象放置在此对象上，则有效地取消拖动操作。如果与其他任何令牌值组合，则会被忽略；例如，“none copy”等同于“copy”值。

popup

有一个弹出菜单或对话框，允许用户选择拖动操作（复制、移动、链接、执行）和任何其他拖动功能（如取消）。

相关角色

用于 **所有** 角色。

规范

另见

• aria-grabbed
• HTML全局 draggable 属性
• HTML 拖放 API
• DataTransfer
• DataTransfer.dropEffect
• dragstart