aria-grabbed

The aria-grabbed state indicates an element's "grabbed" state in a drag-and-drop operation.

Description

Text selections, images, and links can be dragged by default. Setting the global draggable="true" attribute, part of HTML5's Drag and Drop API, with a dragstart event handler, means any DOM node can be made draggable as well.

The aria-grabbed attribute was used to indicate if an element is in a "grabbed" state in a drag-and-drop operation with aria-grabbed="true" or if that the element is grabbable, but not currently grabbed witharia-grabbed="false".

Setting aria-grabbed="true" indicated the element had been selected for dragging. Setting aria-grabbed="false" indicated that the element could be grabbed for a drag-and-drop operation, but is not currently grabbed.

When aria-grabbed is set to true, the aria-dropeffect attribute of all potential drop targets should be updated with the type of function, or effect, will occur to the grabbed element when it is dropped. When no element is in a grabbed state, revert the aria-dropeffect attributes of all your drop targets.

The aria-grabbed property is expected to be replaced by a new feature in a future version of WAI-ARIA and is considered deprecated.

Note: ARIA does not enable accessible functionality. ARIA only conveys the intended behavior of your functionality.

Values

true

The element has been selected for dragging.

false

The element is not currently selected for dragging, but can be made available for dragging by setting the property to true.

undefined (default)

The element does not support being dragge

Associated roles

Used in ALL roles

Specifications

Specification Status
Accessible Rich Internet Applications (WAI-ARIA) 1.1
The definition of 'ARIA: aria-grabbed Attribute' in that specification.
Recommendation

See Also