/** * @license * Visual Blocks Editor * * Copyright 2011 Google Inc. * https://developers.google.com/blockly/ * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /** * @fileoverview Object representing a trash can icon. * @author fraser@google.com (Neil Fraser) */ 'use strict'; goog.provide('Blockly.Trashcan'); goog.require('goog.Timer'); goog.require('goog.dom'); goog.require('goog.math'); goog.require('goog.math.Rect'); /** * Class for a trash can. * @param {!Blockly.Workspace} workspace The workspace to sit in. * @constructor */ Blockly.Trashcan = function(workspace) { this.workspace_ = workspace; }; /** * URL of the sprite image. * @type {string} * @private */ Blockly.Trashcan.prototype.SPRITE_URL_ = 'media/sprites.png'; /** * URL of the lid image. * @type {string} * @private */ Blockly.Trashcan.prototype.LID_URL_ = 'media/trashlid.png'; /** * Width of both the trash can and lid images. * @type {number} * @private */ Blockly.Trashcan.prototype.WIDTH_ = 47; /** * Height of the trashcan image (minus lid). * @type {number} * @private */ Blockly.Trashcan.prototype.BODY_HEIGHT_ = 45; /** * Height of the lid image. * @type {number} * @private */ Blockly.Trashcan.prototype.LID_HEIGHT_ = 15; /** * Distance between trashcan and bottom edge of workspace. * @type {number} * @private */ Blockly.Trashcan.prototype.MARGIN_BOTTOM_ = 35; /** * Distance between trashcan and right edge of workspace. * @type {number} * @private */ Blockly.Trashcan.prototype.MARGIN_SIDE_ = 35; /** * Extent of hotspot on all sides beyond the size of the image. * @type {number} * @private */ Blockly.Trashcan.prototype.MARGIN_HOTSPOT_ = 25; /** * Current open/close state of the lid. * @type {boolean} */ Blockly.Trashcan.prototype.isOpen = false; /** * The SVG group containing the trash can. * @type {Element} * @private */ Blockly.Trashcan.prototype.svgGroup_ = null; /** * The SVG image element of the trash can lid. * @type {Element} * @private */ Blockly.Trashcan.prototype.svgLid_ = null; /** * Task ID of opening/closing animation. * @type {number} * @private */ Blockly.Trashcan.prototype.lidTask_ = 0; /** * Current state of lid opening (0.0 = closed, 1.0 = open). * @type {number} * @private */ Blockly.Trashcan.prototype.lidOpen_ = 0; /** * Left coordinate of the trash can. * @type {number} * @private */ Blockly.Trashcan.prototype.left_ = 0; /** * Top coordinate of the trash can. * @type {number} * @private */ Blockly.Trashcan.prototype.top_ = 0; /** * Create the trash can elements. * @return {!Element} The trash can's SVG group. */ Blockly.Trashcan.prototype.createDom = function() { /* Here's the markup that will be generated: */ this.svgGroup_ = Blockly.createSvgElement('g', {}, null); var clip = Blockly.createSvgElement('clipPath', {'id': 'blocklyTrashBodyClipPath'}, this.svgGroup_); Blockly.createSvgElement('rect', {'width': this.WIDTH_, 'height': this.BODY_HEIGHT_, 'y': this.LID_HEIGHT_}, clip); var body = Blockly.createSvgElement('image', {'width': Blockly.SPRITE.width, 'height': Blockly.SPRITE.height, 'y': -32, 'clip-path': 'url(#blocklyTrashBodyClipPath)'}, this.svgGroup_); body.setAttributeNS('http://www.w3.org/1999/xlink', 'xlink:href', Blockly.pathToMedia + Blockly.SPRITE.url); var clip = Blockly.createSvgElement('clipPath', {'id': 'blocklyTrashLidClipPath'}, this.svgGroup_); Blockly.createSvgElement('rect', {'width': this.WIDTH_, 'height': this.LID_HEIGHT_}, clip); this.svgLid_ = Blockly.createSvgElement('image', {'width': Blockly.SPRITE.width, 'height': Blockly.SPRITE.height, 'y': -32, 'clip-path': 'url(#blocklyTrashLidClipPath)'}, this.svgGroup_); this.svgLid_.setAttributeNS('http://www.w3.org/1999/xlink', 'xlink:href', Blockly.pathToMedia + Blockly.SPRITE.url); this.animateLid_(); return this.svgGroup_; }; /** * Initialize the trash can. */ Blockly.Trashcan.prototype.init = function() { this.setOpen_(false); this.position_(); // If the document resizes, reposition the trash can. Blockly.bindEvent_(window, 'resize', this, this.position_); }; /** * Dispose of this trash can. * Unlink from all DOM elements to prevent memory leaks. */ Blockly.Trashcan.prototype.dispose = function() { if (this.svgGroup_) { goog.dom.removeNode(this.svgGroup_); this.svgGroup_ = null; } this.svgLid_ = null; this.workspace_ = null; goog.Timer.clear(this.lidTask_); }; /** * Move the trash can to the bottom-right corner. * @private */ Blockly.Trashcan.prototype.position_ = function() { var metrics = this.workspace_.getMetrics(); if (!metrics) { // There are no metrics available (workspace is probably not visible). return; } if (Blockly.RTL) { this.left_ = this.MARGIN_SIDE_; } else { this.left_ = metrics.viewWidth + metrics.absoluteLeft - this.WIDTH_ - this.MARGIN_SIDE_; } this.top_ = metrics.viewHeight + metrics.absoluteTop - (this.BODY_HEIGHT_ + this.LID_HEIGHT_) - this.MARGIN_BOTTOM_; this.svgGroup_.setAttribute('transform', 'translate(' + this.left_ + ',' + this.top_ + ')'); }; /** * Return the deletion rectangle for this trashcan. * @return {goog.math.Rect} Rectangle in which to delete. */ Blockly.Trashcan.prototype.getRect = function() { var trashXY = Blockly.getSvgXY_(this.svgGroup_); return new goog.math.Rect( trashXY.x - this.MARGIN_HOTSPOT_, trashXY.y - this.MARGIN_HOTSPOT_, this.WIDTH_ + 2 * this.MARGIN_HOTSPOT_, this.BODY_HEIGHT_ + this.LID_HEIGHT_ + 2 * this.MARGIN_HOTSPOT_); }; /** * Flip the lid open or shut. * @param {boolean} state True if open. * @private */ Blockly.Trashcan.prototype.setOpen_ = function(state) { if (this.isOpen == state) { return; } goog.Timer.clear(this.lidTask_); this.isOpen = state; this.animateLid_(); }; /** * Rotate the lid open or closed by one step. Then wait and recurse. * @private */ Blockly.Trashcan.prototype.animateLid_ = function() { this.lidOpen_ += this.isOpen ? 0.2 : -0.2; this.lidOpen_ = goog.math.clamp(this.lidOpen_, 0, 1); var lidAngle = this.lidOpen_ * 45; this.svgLid_.setAttribute('transform', 'rotate(' + (Blockly.RTL ? -lidAngle : lidAngle) + ', ' + (Blockly.RTL ? 4 : this.WIDTH_ - 4) + ', ' + (this.LID_HEIGHT_ - 2) + ')'); var opacity = goog.math.lerp(0.4, 0.8, this.lidOpen_); this.svgGroup_.style.opacity = opacity; if (this.lidOpen_ > 0 && this.lidOpen_ < 1) { this.lidTask_ = goog.Timer.callOnce(this.animateLid_, 20, this); } }; /** * Flip the lid shut. * Called externally after a drag. */ Blockly.Trashcan.prototype.close = function() { this.setOpen_(false); };