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

另請參閱