Skip to main content

Class: DragTarget

Defined in: packages/blockly/core/drag_target.ts:23

Abstract class for a component with custom behaviour when a block or bubble is dragged over or dropped on top of it.

Extended by​

Implements​

Properties index​

PropertyDescription
idThe unique id for this component that is used to register with the ComponentManager.

Methods index​

MethodDescription
onDragEnterHandles when a cursor with a block or bubble enters this drag target.
onDragOverHandles when a cursor with a block or bubble is dragged over this drag target.
onDragExitHandles when a cursor with a block or bubble exits this drag target.
onDropHandles when a block or bubble is dropped on this component. Should not handle delete here.
getClientRectReturns the bounding rectangle of the drag target area in pixel units relative to the Blockly injection div.
shouldPreventMoveReturns whether the provided block or bubble should not be moved after being dropped on this component. If true, the element will return to where it was when the drag started.

Constructors​

Constructor​

new DragTarget(): DragTarget;

Defined in: packages/blockly/core/drag_target.ts:35

Constructor for DragTarget. It exists to add the id property and should not be called directly, only by a subclass.

Returns​

DragTarget

Properties​

id​

id: string;

Defined in: packages/blockly/core/drag_target.ts:29

The unique id for this component that is used to register with the ComponentManager.

Implementation of​

IDragTarget.id

Methods​

onDragEnter()​

onDragEnter(_dragElement): void;

Defined in: packages/blockly/core/drag_target.ts:42

Handles when a cursor with a block or bubble enters this drag target.

Parameters​

ParameterTypeDescription
_dragElementIDraggableThe block or bubble currently being dragged.

Returns​

void

Implementation of​

IDragTarget.onDragEnter


onDragOver()​

onDragOver(_dragElement): void;

Defined in: packages/blockly/core/drag_target.ts:52

Handles when a cursor with a block or bubble is dragged over this drag target.

Parameters​

ParameterTypeDescription
_dragElementIDraggableThe block or bubble currently being dragged.

Returns​

void

Implementation of​

IDragTarget.onDragOver


onDragExit()​

onDragExit(_dragElement): void;

Defined in: packages/blockly/core/drag_target.ts:61

Handles when a cursor with a block or bubble exits this drag target.

Parameters​

ParameterTypeDescription
_dragElementIDraggableThe block or bubble currently being dragged.

Returns​

void

Implementation of​

IDragTarget.onDragExit


onDrop()​

onDrop(_dragElement): void;

Defined in: packages/blockly/core/drag_target.ts:70

Handles when a block or bubble is dropped on this component. Should not handle delete here.

Parameters​

ParameterTypeDescription
_dragElementIDraggableThe block or bubble currently being dragged.

Returns​

void

Implementation of​

IDragTarget.onDrop


getClientRect()​

getClientRect(): Rect | null;

Defined in: packages/blockly/core/drag_target.ts:81

Returns the bounding rectangle of the drag target area in pixel units relative to the Blockly injection div.

Returns​

Rect | null

The component's bounding box. Null if drag target area should be ignored.

Implementation of​

IDragTarget.getClientRect


shouldPreventMove()​

shouldPreventMove(_dragElement): boolean;

Defined in: packages/blockly/core/drag_target.ts:94

Returns whether the provided block or bubble should not be moved after being dropped on this component. If true, the element will return to where it was when the drag started.

Parameters​

ParameterTypeDescription
_dragElementIDraggableThe block or bubble currently being dragged.

Returns​

boolean

Whether the block or bubble provided should be returned to drag start.

Implementation of​

IDragTarget.shouldPreventMove