Skip to main content

Interface: IDragTarget

Defined in: packages/blockly/core/interfaces/i_drag_target.ts:17

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

Extends​

Extended by​

Properties index​

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

Methods index​

MethodDescription
getClientRectReturns the bounding rectangle of the drag target area in pixel units relative to viewport.
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.
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.

Properties​

id​

id: string;

Defined in: packages/blockly/core/interfaces/i_component.ts:18

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

Inherited from​

IComponent.id

Methods​

getClientRect()​

getClientRect(): Rect | null;

Defined in: packages/blockly/core/interfaces/i_drag_target.ts:25

Returns the bounding rectangle of the drag target area in pixel units relative to viewport.

Returns​

Rect | null

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


onDragEnter()​

onDragEnter(dragElement): void;

Defined in: packages/blockly/core/interfaces/i_drag_target.ts:32

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

Parameters​

ParameterTypeDescription
dragElementIDraggableThe block or bubble currently being dragged.

Returns​

void


onDragOver()​

onDragOver(dragElement): void;

Defined in: packages/blockly/core/interfaces/i_drag_target.ts:40

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


onDragExit()​

onDragExit(dragElement): void;

Defined in: packages/blockly/core/interfaces/i_drag_target.ts:47

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

Parameters​

ParameterTypeDescription
dragElementIDraggableThe block or bubble currently being dragged.

Returns​

void


onDrop()​

onDrop(dragElement): void;

Defined in: packages/blockly/core/interfaces/i_drag_target.ts:55

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


shouldPreventMove()​

shouldPreventMove(dragElement): boolean;

Defined in: packages/blockly/core/interfaces/i_drag_target.ts:66

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.