mirror of
https://github.com/google/blockly.git
synced 2026-01-10 10:27:08 +01:00
f70f82327b
* refactor: Remove uses of AnyDuringMigration from trashcan.ts. * refactor: Remove uses of AnyDuringMigration in bubble.ts. * refactor: Remove uses of AnyDuringMigration from connection_checker.ts. * refactor: Remove uses of AnyDuringMigration from connection_db.ts. * refactor: Remove uses of AnyDuringMigration in contextmenu_items.ts. * refactor: Remove uses of AnyDuringMigration from grid.ts. * refactor: Remove uses of AnyDuringMigration from i_drag_target.ts. * refactor: Remove uses of AnyDuringMigration from i_ast_node_location_svg.ts. * refactor: Remove uses of AnyDuringMigration from i_ast_node_location_with_block.ts. * refactor: Remove uses of AnyDuringMigration from i_autohideable.ts. * refactor: Remove uses of AnyDuringMigration from i_block_dragger.ts. * refactor: Remove uses of AnyDuringMigration from i_bounded_element.ts. * refactor: Remove uses of AnyDuringMigration from i_bubble.ts. * refactor: Remove uses of AnyDuringMigration from i_collapsible_toolbox_item.ts. * refactor: Remove uses of AnyDuringMigration from i_connection_checker.ts. * refactor: Remove uses of AnyDuringMigration from i_contextmenu.ts. * refactor: Remove uses of AnyDuringMigration in i_copyable.ts. * refactor: Remove uses of AnyDuringMigration from i_deleteable.ts. * refactor: Remove uses of AnyDuringMigration from i_delete_area.ts. * refactor: Remove uses of AnyDuringMigration in i_flyout.ts. * refactor: Remove uses of AnyDuringMigration in i_keyboard_accessible.ts. * refactor: Remove uses of AnyDuringMigration in i_metrics_manager.ts. * refactor: Remove uses of AnyDuringMigration from i_movable.ts. * refactor: Remove uses of AnyDuringMigration in i_positionable.ts. * refactor: Remove uses of AnyDuringMigration in i_selectable_toolbox_item.ts. * refactor: Remove uses of AnyDuringMigration from i_selectable.ts. * refactor: Remove uses of AnyDuringMigration in i_serializer.ts. * refactor: Remove uses of AnyDuringMigration from i_styleable.ts. * refactor: Remove uses of AnyDuringMigration in i_toolbox.ts. * refactor: Make non-null checks explicit.
89 lines
2.7 KiB
TypeScript
89 lines
2.7 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright 2020 Google LLC
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
/**
|
|
* @fileoverview The interface for a bubble.
|
|
*/
|
|
|
|
/**
|
|
* The interface for a bubble.
|
|
* @namespace Blockly.IBubble
|
|
*/
|
|
import * as goog from '../../closure/goog/goog.js';
|
|
import type {Coordinate} from '../utils/coordinate.js';
|
|
import type {BlockDragSurfaceSvg} from '../block_drag_surface.js';
|
|
goog.declareModuleId('Blockly.IBubble');
|
|
|
|
/* eslint-disable-next-line no-unused-vars */
|
|
// Unused import preserved for side-effects. Remove if unneeded.
|
|
// import '../block_drag_surface.js';
|
|
/* eslint-disable-next-line no-unused-vars */
|
|
// Unused import preserved for side-effects. Remove if unneeded.
|
|
// import '../utils/coordinate.js';
|
|
|
|
import type {IContextMenu} from './i_contextmenu.js';
|
|
import type {IDraggable} from './i_draggable.js';
|
|
|
|
|
|
/**
|
|
* A bubble interface.
|
|
* @alias Blockly.IBubble
|
|
*/
|
|
export interface IBubble extends IDraggable, IContextMenu {
|
|
/**
|
|
* Return the coordinates of the top-left corner of this bubble's body
|
|
* relative to the drawing surface's origin (0,0), in workspace units.
|
|
* @return Object with .x and .y properties.
|
|
*/
|
|
getRelativeToSurfaceXY(): Coordinate;
|
|
|
|
/**
|
|
* Return the root node of the bubble's SVG group.
|
|
* @return The root SVG node of the bubble's group.
|
|
*/
|
|
getSvgRoot(): SVGElement;
|
|
|
|
/**
|
|
* Set whether auto-layout of this bubble is enabled. The first time a bubble
|
|
* is shown it positions itself to not cover any blocks. Once a user has
|
|
* dragged it to reposition, it renders where the user put it.
|
|
* @param enable True if auto-layout should be enabled, false otherwise.
|
|
*/
|
|
setAutoLayout(enable: boolean): void;
|
|
|
|
/**
|
|
* Sets whether or not this bubble is being dragged.
|
|
* @param adding True if dragging, false otherwise.
|
|
*/
|
|
setDragging(dragging: boolean): void;
|
|
|
|
/**
|
|
* Move this bubble during a drag, taking into account whether or not there is
|
|
* a drag surface.
|
|
* @param dragSurface The surface that carries rendered items during a drag,
|
|
* or null if no drag surface is in use.
|
|
* @param newLoc The location to translate to, in workspace coordinates.
|
|
*/
|
|
moveDuringDrag(dragSurface: BlockDragSurfaceSvg|null, newLoc: Coordinate):
|
|
void;
|
|
|
|
/**
|
|
* Move the bubble to the specified location in workspace coordinates.
|
|
* @param x The x position to move to.
|
|
* @param y The y position to move to.
|
|
*/
|
|
moveTo(x: number, y: number): void;
|
|
|
|
/**
|
|
* Update the style of this bubble when it is dragged over a delete area.
|
|
* @param enable True if the bubble is about to be deleted, false otherwise.
|
|
*/
|
|
setDeleteStyle(enable: boolean): void;
|
|
|
|
/** Dispose of this bubble. */
|
|
dispose(): void;
|
|
}
|