/** * @license * Copyright 2019 Google LLC * SPDX-License-Identifier: Apache-2.0 */ /** * @fileoverview Text Area field. * @author fraser@google.com (Neil Fraser) * @author Andrew Mee * @author acbart@udel.edu (Austin Cory Bart) */ 'use strict'; goog.provide('Blockly.FieldMultilineInput'); goog.require('Blockly.Css'); goog.require('Blockly.DropDownDiv'); goog.require('Blockly.FieldTextInput'); goog.require('Blockly.utils'); goog.require('Blockly.utils.aria'); goog.require('Blockly.utils.Coordinate'); goog.require('Blockly.utils.dom'); goog.require('Blockly.utils.KeyCodes'); goog.require('Blockly.utils.object'); goog.require('Blockly.utils.userAgent'); /** * Class for an editable text area field. * @param {string=} opt_value The initial content of the field. Should cast to a * string. Defaults to an empty string if null or undefined. * @param {Function=} opt_validator An optional function that is called * to validate any constraints on what the user entered. Takes the new * text as an argument and returns either the accepted text, a replacement * text, or null to abort the change. * @param {Object=} opt_config A map of options used to configure the field. * See the [field creation documentation]{@link https://developers.google.com/blockly/guides/create-custom-blocks/fields/built-in-fields/text-input#creation} * for a list of properties this parameter supports. * @extends {Blockly.FieldTextInput} * @constructor */ Blockly.FieldMultilineInput = function(opt_value, opt_validator, opt_config) { // TODO: Once this field is documented the opt_config link should point to its // creation documentation, rather than the text input field's. Blockly.FieldMultilineInput.superClass_.constructor.call(this, opt_value, opt_validator, opt_config); /** * The SVG group element that will contain a text element for each text row * when initialized. * @type {SVGGElement} */ this.textGroup_ = null; }; Blockly.utils.object.inherits(Blockly.FieldMultilineInput, Blockly.FieldTextInput); /** * Construct a FieldMultilineInput from a JSON arg object, * dereferencing any string table references. * @param {!Object} options A JSON object with options (text, and spellcheck). * @return {!Blockly.FieldMultilineInput} The new field instance. * @package * @nocollapse */ Blockly.FieldMultilineInput.fromJson = function(options) { var text = Blockly.utils.replaceMessageReferences(options['text']); return new Blockly.FieldMultilineInput(text, undefined, options); }; /** * Create the block UI for this field. * @package */ Blockly.FieldMultilineInput.prototype.initView = function() { this.createBorderRect_(); this.textGroup_ = Blockly.utils.dom.createSvgElement( Blockly.utils.dom.SvgElementType.G, { 'class': 'blocklyEditableText', }, this.fieldGroup_); }; /** * Get the text from this field as displayed on screen. May differ from getText * due to ellipsis, and other formatting. * @return {string} Currently displayed text. * @private */ Blockly.FieldMultilineInput.prototype.getDisplayText_ = function() { var value = this.value_; if (!value) { // Prevent the field from disappearing if empty. return Blockly.Field.NBSP; } var lines = value.split('\n'); value = ''; for (var i = 0; i < lines.length; i++) { var text = lines[i]; if (text.length > this.maxDisplayLength) { // Truncate displayed string and add an ellipsis ('...'). text = text.substring(0, this.maxDisplayLength - 4) + '...'; } // Replace whitespace with non-breaking spaces so the text doesn't collapse. text = text.replace(/\s/g, Blockly.Field.NBSP); value += text; if (i !== lines.length - 1) { value += '\n'; } } if (this.sourceBlock_.RTL) { // The SVG is LTR, force value to be RTL. value += '\u200F'; } return value; }; /** * Updates the text of the textElement. * @protected */ Blockly.FieldMultilineInput.prototype.render_ = function() { // Remove all text group children. var currentChild; while ((currentChild = this.textGroup_.firstChild)) { this.textGroup_.removeChild(currentChild); } // Add in text elements into the group. var lines = this.getDisplayText_().split('\n'); var y = 0; for (var i = 0; i < lines.length; i++) { var lineHeight = this.getConstants().FIELD_TEXT_HEIGHT + this.getConstants().FIELD_BORDER_RECT_Y_PADDING; var span = Blockly.utils.dom.createSvgElement( Blockly.utils.dom.SvgElementType.TEXT, { 'class': 'blocklyText blocklyMultilineText', x: this.getConstants().FIELD_BORDER_RECT_X_PADDING, y: y + this.getConstants().FIELD_BORDER_RECT_Y_PADDING, dy: this.getConstants().FIELD_TEXT_BASELINE }, this.textGroup_); span.appendChild(document.createTextNode(lines[i])); y += lineHeight; } this.updateSize_(); if (this.isBeingEdited_) { if (this.sourceBlock_.RTL) { // in RTL, we need to let the browser reflow before resizing // in order to get the correct bounding box of the borderRect // avoiding issue #2777. setTimeout(this.resizeEditor_.bind(this), 0); } else { this.resizeEditor_(); } var htmlInput = /** @type {!HTMLElement} */(this.htmlInput_); if (!this.isTextValid_) { Blockly.utils.dom.addClass(htmlInput, 'blocklyInvalidInput'); Blockly.utils.aria.setState(htmlInput, Blockly.utils.aria.State.INVALID, true); } else { Blockly.utils.dom.removeClass(htmlInput, 'blocklyInvalidInput'); Blockly.utils.aria.setState(htmlInput, Blockly.utils.aria.State.INVALID, false); } } }; /** * Updates the size of the field based on the text. * @protected */ Blockly.FieldMultilineInput.prototype.updateSize_ = function() { var nodes = this.textGroup_.childNodes; var totalWidth = 0; var totalHeight = 0; for (var i = 0; i < nodes.length; i++) { var tspan = /** @type {!Element} */ (nodes[i]); var textWidth = Blockly.utils.dom.getTextWidth(tspan); if (textWidth > totalWidth) { totalWidth = textWidth; } totalHeight += this.getConstants().FIELD_TEXT_HEIGHT + (i > 0 ? this.getConstants().FIELD_BORDER_RECT_Y_PADDING : 0); } if (this.borderRect_) { totalHeight += this.getConstants().FIELD_BORDER_RECT_Y_PADDING * 2; totalWidth += this.getConstants().FIELD_BORDER_RECT_X_PADDING * 2; this.borderRect_.setAttribute('width', totalWidth); this.borderRect_.setAttribute('height', totalHeight); } this.size_.width = totalWidth; this.size_.height = totalHeight; this.positionBorderRect_(); }; /** * Create the text input editor widget. * @return {!HTMLTextAreaElement} The newly created text input editor. * @protected */ Blockly.FieldMultilineInput.prototype.widgetCreate_ = function() { var div = Blockly.WidgetDiv.DIV; var scale = this.workspace_.getScale(); var htmlInput = /** @type {HTMLTextAreaElement} */ (document.createElement('textarea')); htmlInput.className = 'blocklyHtmlInput blocklyHtmlTextAreaInput'; htmlInput.setAttribute('spellcheck', this.spellcheck_); var fontSize = (this.getConstants().FIELD_TEXT_FONTSIZE * scale) + 'pt'; div.style.fontSize = fontSize; htmlInput.style.fontSize = fontSize; var borderRadius = (Blockly.FieldTextInput.BORDERRADIUS * scale) + 'px'; htmlInput.style.borderRadius = borderRadius; var paddingX = this.getConstants().FIELD_BORDER_RECT_X_PADDING * scale; var paddingY = this.getConstants().FIELD_BORDER_RECT_Y_PADDING * scale / 2; htmlInput.style.padding = paddingY + 'px ' + paddingX + 'px ' + paddingY + 'px ' + paddingX + 'px'; var lineHeight = this.getConstants().FIELD_TEXT_HEIGHT + this.getConstants().FIELD_BORDER_RECT_Y_PADDING; htmlInput.style.lineHeight = (lineHeight * scale) + 'px'; div.appendChild(htmlInput); htmlInput.value = htmlInput.defaultValue = this.getEditorText_(this.value_); htmlInput.untypedDefaultValue_ = this.value_; htmlInput.oldValue_ = null; if (Blockly.utils.userAgent.GECKO) { // In FF, ensure the browser reflows before resizing to avoid issue #2777. setTimeout(this.resizeEditor_.bind(this), 0); } else { this.resizeEditor_(); } this.bindInputEvents_(htmlInput); return htmlInput; }; /** * Handle key down to the editor. Override the text input definition of this * so as to not close the editor when enter is typed in. * @param {!Event} e Keyboard event. * @protected */ Blockly.FieldMultilineInput.prototype.onHtmlInputKeyDown_ = function(e) { if (e.keyCode !== Blockly.utils.KeyCodes.ENTER) { Blockly.FieldMultilineInput.superClass_.onHtmlInputKeyDown_.call(this, e); } }; /** * CSS for multiline field. See css.js for use. */ Blockly.Css.register([ /* eslint-disable indent */ '.blocklyHtmlTextAreaInput {', 'font-family: monospace;', 'resize: none;', 'overflow: hidden;', 'height: 100%;', 'text-align: left;', '}' /* eslint-enable indent */ ]); Blockly.fieldRegistry.register('field_multilinetext', Blockly.FieldMultilineInput);