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