mirror of
https://github.com/google/blockly.git
synced 2026-01-09 10:00:09 +01:00
4c40378b9a
* Use goog.requireType when importing I* interfaces Interfaces have no code, so should never be referred to outside of (JSDoc) comments, and so the modules that define only interfaces never need to be goog.require'd - goog.requireType is always sufficient. This commit fixes imports of all modules whose name matches /(.*\.)?I[A-Z]*/ - i.e., the hungarian-notation named ones in core/interfaces/. * Use goog.requireType when only using import for type specifications Where a module is imported only to used in JSDoc comments it can (and should) be goog.requireType'd instead of goog.require'd. * Remove spurious eslint-disable no-unused-vars There were a few cases where modules were being imported with goog.require (because they are referred to in code, not just JSDoc comments) but were prefaced by a spurious eslint suppress. Remove these, restoring the invariant that an import gets an eslint if and only if it is a requireType. * Remove obsolete Closure Compiler error group stricterMissingRequire has been superceded by missingRequire, and now causes a Java null pointer exception if supplied.
94 lines
2.6 KiB
JavaScript
94 lines
2.6 KiB
JavaScript
/**
|
|
* @license
|
|
* Copyright 2021 Google LLC
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @fileoverview The abstract class for a component with custom behaviour when a
|
|
* block or bubble is dragged over or dropped on top of it.
|
|
* @author kozbial@google.com (Monica Kozbial)
|
|
*/
|
|
|
|
'use strict';
|
|
|
|
goog.module('Blockly.DragTarget');
|
|
goog.module.declareLegacyNamespace();
|
|
|
|
/* eslint-disable-next-line no-unused-vars */
|
|
const IDragTarget = goog.requireType('Blockly.IDragTarget');
|
|
/* eslint-disable-next-line no-unused-vars */
|
|
const IDraggable = goog.requireType('Blockly.IDraggable');
|
|
/* eslint-disable-next-line no-unused-vars */
|
|
const Rect = goog.requireType('Blockly.utils.Rect');
|
|
|
|
|
|
/**
|
|
* Abstract class for a component with custom behaviour when a block or bubble
|
|
* is dragged over or dropped on top of it.
|
|
* @implements {IDragTarget}
|
|
* @constructor
|
|
*/
|
|
const DragTarget = function() {};
|
|
|
|
/**
|
|
* Returns the bounding rectangle of the drag target area in pixel units
|
|
* relative to the Blockly injection div.
|
|
* @return {?Rect} The component's bounding box. Null if drag
|
|
* target area should be ignored.
|
|
*/
|
|
DragTarget.prototype.getClientRect;
|
|
|
|
/**
|
|
* Handles when a cursor with a block or bubble enters this drag target.
|
|
* @param {!IDraggable} _dragElement The block or bubble currently being
|
|
* dragged.
|
|
*/
|
|
DragTarget.prototype.onDragEnter = function(_dragElement) {
|
|
// no-op
|
|
};
|
|
|
|
/**
|
|
* Handles when a cursor with a block or bubble is dragged over this drag
|
|
* target.
|
|
* @param {!IDraggable} _dragElement The block or bubble currently being
|
|
* dragged.
|
|
*/
|
|
DragTarget.prototype.onDragOver = function(_dragElement) {
|
|
// no-op
|
|
};
|
|
|
|
/**
|
|
* Handles when a cursor with a block or bubble exits this drag target.
|
|
* @param {!IDraggable} _dragElement The block or bubble currently being
|
|
* dragged.
|
|
*/
|
|
DragTarget.prototype.onDragExit = function(_dragElement) {
|
|
// no-op
|
|
};
|
|
|
|
/**
|
|
* Handles when a block or bubble is dropped on this component.
|
|
* Should not handle delete here.
|
|
* @param {!IDraggable} _dragElement The block or bubble currently being
|
|
* dragged.
|
|
*/
|
|
DragTarget.prototype.onDrop = function(_dragElement) {
|
|
// no-op
|
|
};
|
|
|
|
/**
|
|
* 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.
|
|
* @param {!IDraggable} _dragElement The block or bubble currently being
|
|
* dragged.
|
|
* @return {boolean} Whether the block or bubble provided should be returned to
|
|
* drag start.
|
|
*/
|
|
DragTarget.prototype.shouldPreventMove = function(_dragElement) {
|
|
return false;
|
|
};
|
|
|
|
exports = DragTarget;
|