/** * @license * Copyright 2017 Google LLC * SPDX-License-Identifier: Apache-2.0 */ /** * @fileoverview Layout code for a vertical variant of the flyout. * @author fenichel@google.com (Rachel Fenichel) */ 'use strict'; goog.provide('Blockly.VerticalFlyout'); /** @suppress {extraRequire} */ goog.require('Blockly.Block'); /** @suppress {extraRequire} */ goog.require('Blockly.constants'); goog.require('Blockly.DropDownDiv'); goog.require('Blockly.Flyout'); goog.require('Blockly.registry'); goog.require('Blockly.Scrollbar'); goog.require('Blockly.utils'); goog.require('Blockly.utils.object'); goog.require('Blockly.utils.Rect'); goog.require('Blockly.utils.toolbox'); goog.require('Blockly.WidgetDiv'); goog.requireType('Blockly.Options'); goog.requireType('Blockly.utils.Coordinate'); /** * Class for a flyout. * @param {!Blockly.Options} workspaceOptions Dictionary of options for the * workspace. * @extends {Blockly.Flyout} * @constructor */ Blockly.VerticalFlyout = function(workspaceOptions) { Blockly.VerticalFlyout.superClass_.constructor.call(this, workspaceOptions); }; Blockly.utils.object.inherits(Blockly.VerticalFlyout, Blockly.Flyout); /** * The name of the vertical flyout in the registry. * @type {string} */ Blockly.VerticalFlyout.registryName = 'verticalFlyout'; /** * Sets the translation of the flyout to match the scrollbars. * @param {!{x:number,y:number}} xyRatio Contains a y property which is a float * between 0 and 1 specifying the degree of scrolling and a * similar x property. * @protected */ Blockly.VerticalFlyout.prototype.setMetrics_ = function(xyRatio) { if (!this.isVisible()) { return; } var metricsManager = this.workspace_.getMetricsManager(); var scrollMetrics = metricsManager.getScrollMetrics(); var viewMetrics = metricsManager.getViewMetrics(); var absoluteMetrics = metricsManager.getAbsoluteMetrics(); if (typeof xyRatio.y == 'number') { this.workspace_.scrollY = -(scrollMetrics.top + (scrollMetrics.height - viewMetrics.height) * xyRatio.y); } this.workspace_.translate(this.workspace_.scrollX + absoluteMetrics.left, this.workspace_.scrollY + absoluteMetrics.top); }; /** * Calculates the x coordinate for the flyout position. * @return {number} X coordinate. */ Blockly.VerticalFlyout.prototype.getX = function() { if (!this.isVisible()) { return 0; } var metricsManager = this.targetWorkspace.getMetricsManager(); var absoluteMetrics = metricsManager.getAbsoluteMetrics(); var viewMetrics = metricsManager.getViewMetrics(); var toolboxMetrics = metricsManager.getToolboxMetrics(); var x = 0; // If this flyout is not the trashcan flyout (e.g. toolbox or mutator). if (this.targetWorkspace.toolboxPosition == this.toolboxPosition_) { // If there is a category toolbox. if (this.targetWorkspace.getToolbox()) { if (this.toolboxPosition_ == Blockly.utils.toolbox.Position.LEFT) { x = toolboxMetrics.width; } else { x = viewMetrics.width - this.width_; } // Simple (flyout-only) toolbox. } else { if (this.toolboxPosition_ == Blockly.utils.toolbox.Position.LEFT) { x = 0; } else { // The simple flyout does not cover the workspace. x = viewMetrics.width; } } // Trashcan flyout is opposite the main flyout. } else { if (this.toolboxPosition_ == Blockly.utils.toolbox.Position.LEFT) { x = 0; } else { // Because the anchor point of the flyout is on the left, but we want // to align the right edge of the flyout with the right edge of the // blocklyDiv, we calculate the full width of the div minus the width // of the flyout. x = viewMetrics.width + absoluteMetrics.left - this.width_; } } return x; }; /** * Calculates the y coordinate for the flyout position. * @return {number} Y coordinate. */ Blockly.VerticalFlyout.prototype.getY = function() { // Y is always 0 since this is a vertical flyout. return 0; }; /** * Move the flyout to the edge of the workspace. */ Blockly.VerticalFlyout.prototype.position = function() { if (!this.isVisible() || !this.targetWorkspace.isVisible()) { return; } var metricsManager = this.targetWorkspace.getMetricsManager(); var targetWorkspaceViewMetrics = metricsManager.getViewMetrics(); // Record the height for workspace metrics. this.height_ = targetWorkspaceViewMetrics.height; var edgeWidth = this.width_ - this.CORNER_RADIUS; var edgeHeight = targetWorkspaceViewMetrics.height - 2 * this.CORNER_RADIUS; this.setBackgroundPath_(edgeWidth, edgeHeight); var x = this.getX(); var y = this.getY(); this.positionAt_(this.width_, this.height_, x, y); }; /** * Create and set the path for the visible boundaries of the flyout. * @param {number} width The width of the flyout, not including the * rounded corners. * @param {number} height The height of the flyout, not including * rounded corners. * @private */ Blockly.VerticalFlyout.prototype.setBackgroundPath_ = function(width, height) { var atRight = this.toolboxPosition_ == Blockly.utils.toolbox.Position.RIGHT; var totalWidth = width + this.CORNER_RADIUS; // Decide whether to start on the left or right. var path = ['M ' + (atRight ? totalWidth : 0) + ',0']; // Top. path.push('h', atRight ? -width : width); // Rounded corner. path.push('a', this.CORNER_RADIUS, this.CORNER_RADIUS, 0, 0, atRight ? 0 : 1, atRight ? -this.CORNER_RADIUS : this.CORNER_RADIUS, this.CORNER_RADIUS); // Side closest to workspace. path.push('v', Math.max(0, height)); // Rounded corner. path.push('a', this.CORNER_RADIUS, this.CORNER_RADIUS, 0, 0, atRight ? 0 : 1, atRight ? this.CORNER_RADIUS : -this.CORNER_RADIUS, this.CORNER_RADIUS); // Bottom. path.push('h', atRight ? width : -width); path.push('z'); this.svgBackground_.setAttribute('d', path.join(' ')); }; /** * Scroll the flyout to the top. */ Blockly.VerticalFlyout.prototype.scrollToStart = function() { this.workspace_.scrollbar.setY(0); }; /** * Scroll the flyout. * @param {!Event} e Mouse wheel scroll event. * @protected */ Blockly.VerticalFlyout.prototype.wheel_ = function(e) { var scrollDelta = Blockly.utils.getScrollDeltaPixels(e); if (scrollDelta.y) { var metricsManager = this.workspace_.getMetricsManager(); var scrollMetrics = metricsManager.getScrollMetrics(); var viewMetrics = metricsManager.getViewMetrics(); var pos = (viewMetrics.top - scrollMetrics.top) + scrollDelta.y; this.workspace_.scrollbar.setY(pos); // When the flyout moves from a wheel event, hide WidgetDiv and DropDownDiv. Blockly.WidgetDiv.hide(); Blockly.DropDownDiv.hideWithoutAnimation(); } // Don't scroll the page. e.preventDefault(); // Don't propagate mousewheel event (zooming). e.stopPropagation(); }; /** * Lay out the blocks in the flyout. * @param {!Array} contents The blocks and buttons to lay out. * @param {!Array} gaps The visible gaps between blocks. * @protected */ Blockly.VerticalFlyout.prototype.layout_ = function(contents, gaps) { this.workspace_.scale = this.targetWorkspace.scale; var margin = this.MARGIN; var cursorX = this.RTL ? margin : margin + this.tabWidth_; var cursorY = margin; for (var i = 0, item; (item = contents[i]); i++) { if (item.type == 'block') { var block = item.block; var allBlocks = block.getDescendants(false); for (var j = 0, child; (child = allBlocks[j]); j++) { // Mark blocks as being inside a flyout. This is used to detect and // prevent the closure of the flyout if the user right-clicks on such a // block. child.isInFlyout = true; } block.render(); var root = block.getSvgRoot(); var blockHW = block.getHeightWidth(); var moveX = block.outputConnection ? cursorX - this.tabWidth_ : cursorX; block.moveBy(moveX, cursorY); var rect = this.createRect_(block, this.RTL ? moveX - blockHW.width : moveX, cursorY, blockHW, i); this.addBlockListeners_(root, block, rect); cursorY += blockHW.height + gaps[i]; } else if (item.type == 'button') { this.initFlyoutButton_(item.button, cursorX, cursorY); cursorY += item.button.height + gaps[i]; } } }; /** * Determine if a drag delta is toward the workspace, based on the position * and orientation of the flyout. This is used in determineDragIntention_ to * determine if a new block should be created or if the flyout should scroll. * @param {!Blockly.utils.Coordinate} currentDragDeltaXY How far the pointer has * moved from the position at mouse down, in pixel units. * @return {boolean} True if the drag is toward the workspace. * @package */ Blockly.VerticalFlyout.prototype.isDragTowardWorkspace = function( currentDragDeltaXY) { var dx = currentDragDeltaXY.x; var dy = currentDragDeltaXY.y; // Direction goes from -180 to 180, with 0 toward the right and 90 on top. var dragDirection = Math.atan2(dy, dx) / Math.PI * 180; var range = this.dragAngleRange_; // Check for left or right dragging. if ((dragDirection < range && dragDirection > -range) || (dragDirection < -180 + range || dragDirection > 180 - range)) { return true; } return false; }; /** * Returns the bounding rectangle of the drag target area in pixel units * relative to viewport. * @return {?Blockly.utils.Rect} The component's bounding box. Null if drag * target area should be ignored. */ Blockly.VerticalFlyout.prototype.getClientRect = function() { if (!this.svgGroup_ || this.autoClose || !this.isVisible()) { // The bounding rectangle won't compute correctly if the flyout is closed // and auto-close flyouts aren't valid drag targets (or delete areas). return null; } var flyoutRect = this.svgGroup_.getBoundingClientRect(); // BIG_NUM is offscreen padding so that blocks dragged beyond the shown flyout // area are still deleted. Must be larger than the largest screen size, // but be smaller than half Number.MAX_SAFE_INTEGER (not available on IE). var BIG_NUM = 1000000000; var left = flyoutRect.left; if (this.toolboxPosition_ == Blockly.utils.toolbox.Position.LEFT) { var width = flyoutRect.width; return new Blockly.utils.Rect(-BIG_NUM, BIG_NUM, -BIG_NUM, left + width); } else { // Right return new Blockly.utils.Rect(-BIG_NUM, BIG_NUM, left, BIG_NUM); } }; /** * Compute width of flyout. Position mat under each block. * For RTL: Lay out the blocks and buttons to be right-aligned. * @protected */ Blockly.VerticalFlyout.prototype.reflowInternal_ = function() { this.workspace_.scale = this.getFlyoutScale(); var flyoutWidth = 0; var blocks = this.workspace_.getTopBlocks(false); for (var i = 0, block; (block = blocks[i]); i++) { var width = block.getHeightWidth().width; if (block.outputConnection) { width -= this.tabWidth_; } flyoutWidth = Math.max(flyoutWidth, width); } for (var i = 0, button; (button = this.buttons_[i]); i++) { flyoutWidth = Math.max(flyoutWidth, button.width); } flyoutWidth += this.MARGIN * 1.5 + this.tabWidth_; flyoutWidth *= this.workspace_.scale; flyoutWidth += Blockly.Scrollbar.scrollbarThickness; if (this.width_ != flyoutWidth) { for (var i = 0, block; (block = blocks[i]); i++) { if (this.RTL) { // With the flyoutWidth known, right-align the blocks. var oldX = block.getRelativeToSurfaceXY().x; var newX = flyoutWidth / this.workspace_.scale - this.MARGIN; if (!block.outputConnection) { newX -= this.tabWidth_; } block.moveBy(newX - oldX, 0); } if (block.flyoutRect_) { this.moveRectToBlock_(block.flyoutRect_, block); } } if (this.RTL) { // With the flyoutWidth known, right-align the buttons. for (var i = 0, button; (button = this.buttons_[i]); i++) { var y = button.getPosition().y; var x = flyoutWidth / this.workspace_.scale - button.width - this.MARGIN - this.tabWidth_; button.moveTo(x, y); } } if (this.targetWorkspace.toolboxPosition == this.toolboxPosition_ && this.toolboxPosition_ == Blockly.utils.toolbox.Position.LEFT && !this.targetWorkspace.getToolbox()) { // This flyout is a simple toolbox. Reposition the workspace so that (0,0) // is in the correct position relative to the new absolute edge (ie // toolbox edge). this.targetWorkspace.translate( this.targetWorkspace.scrollX + flyoutWidth, this.targetWorkspace.scrollY); } // Record the width for workspace metrics and .position. this.width_ = flyoutWidth; this.position(); this.targetWorkspace.recordDragTargets(); } }; Blockly.registry.register(Blockly.registry.Type.FLYOUTS_VERTICAL_TOOLBOX, Blockly.registry.DEFAULT, Blockly.VerticalFlyout);