Class: FieldNumber | Blockly | Google Developers

Class: FieldNumber

Constructor

FieldNumber

new FieldNumber(opt_value, opt_min, opt_max, opt_precision, opt_validator)

Class for an editable number field.

Parameter
opt_value	Optional (string or number) The initial content of the field. The value should cast to a number, and if it does not, '0' will be used.
opt_min	Optional (string or number) Minimum value.
opt_max	Optional (string or number) Maximum value.
opt_precision	Optional (string or number) Precision for value.
opt_validator	Optional function() 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.

Extends: Blockly.FieldTextInput

Properties

CURSOR

Mouse cursor style when over the hotspot that initiates the editor.

Inherited from: Blockly.FieldTextInput#CURSOR

EDITABLE

Editable fields are saved by the XML renderer, non-editable fields are not.

Inherited from: Blockly.Field#EDITABLE

maxDisplayLength

unknown

Maximum characters of text to display before adding an ellipsis.

Inherited from: Blockly.Field#maxDisplayLength

name

unknown

Name of field. Unique within each block. Static labels are usually unnamed.

Inherited from: Blockly.Field#name

textElement_

unknown

Inherited from: Blockly.Field#textElement_

Methods

fromJson

static

fromJson(options) returns Blockly.FieldNumber

Construct a FieldNumber from a JSON arg object.

Parameter
options	Object A JSON object with options (value, min, max, and precision). Value must not be null.

Parameter

options

Object

A JSON object with options (value, min, max, and precision).

Value must not be null.

Returns: non-null Blockly.FieldNumber The new field instance.

callValidator

callValidator(text) returns string

Calls the validation function for this field, as well as all the validation function for the field's class and its parents.

Parameter
text	Proposed text.

Inherited from: Blockly.Field#callValidator
Returns: Revised text, or null if invalid.

classValidator

classValidator(text) returns string

Ensure that only a number in the correct range may be entered.

Parameter
text	string The user's text.

Returns: nullable string A string representing a valid number, or null if invalid.

dispose

dispose()

Close the input widget if this input is being deleted.

Inherited from: Blockly.FieldTextInput#dispose

forceRerender

forceRerender()

Force a rerender of the block that this field is installed on, which will rerender this field and adjust for any sizing changes. Other fields on the same block will not rerender, because their sizes have already been recorded.

Inherited from: Blockly.Field#forceRerender

getSize

getSize() returns goog.math.Size

Returns the height and width of the field.

Inherited from: Blockly.Field#getSize
Returns: Height and width.

getSvgRoot

getSvgRoot() returns Element

Gets the group element for this editable field. Used for measuring the size and for positioning.

Inherited from: Blockly.Field#getSvgRoot
Returns: The group element.

getText

getText() returns string

Get the text from this field.

Inherited from: Blockly.Field#getText
Returns: Current text.

getValidator

getValidator() returns function()

Gets the validation function for editable fields.

Inherited from: Blockly.Field#getValidator
Returns: Validation function, or null.

getValue

getValue() returns string

By default there is no difference between the human-readable text and the language-neutral values. Subclasses (such as dropdown) may define this.

Inherited from: Blockly.Field#getValue
Returns: Current value.

init

init()

Install this field on a block.

Inherited from: Blockly.Field#init

initModel

initModel()

Initializes the model of the field after it has been installed on a block. No-op by default.

Inherited from: Blockly.Field#initModel

isCurrentlyEditable

isCurrentlyEditable() returns boolean

Check whether this field is currently editable. Some fields are never editable (e.g. text labels). Those fields are not serialized to XML. Other fields may be editable, and therefore serialized, but may exist on non-editable blocks.

Inherited from: Blockly.Field#isCurrentlyEditable
Returns: whether this field is editable and on an editable block

isVisible

isVisible() returns boolean

Gets whether this editable field is visible or not.

Inherited from: Blockly.Field#isVisible
Returns: True if visible.

referencesVariables

referencesVariables() returns boolean

Whether this field references any Blockly variables. If true it may need to be handled differently during serialization and deserialization. Subclasses may override this.

Inherited from: Blockly.Field#referencesVariables
Returns: True if this field has any variable references.

setConstraints

setConstraints(min, max, precision)

Set the maximum, minimum and precision constraints on this field. Any of these properties may be undefiend or NaN to be disabled. Setting precision (usually a power of 10) enforces a minimum step between values. That is, the user's value will rounded to the closest multiple of precision. The least significant digit place is inferred from the precision. Integers values can be enforces by choosing an integer precision.

Parameter
min	(number, string, or undefined) Minimum value.
max	(number, string, or undefined) Maximum value.
precision	(number, string, or undefined) Precision for value.

Parameter

min

(number, string, or undefined)

Minimum value.

max

(number, string, or undefined)

Maximum value.

precision

(number, string, or undefined)

Precision for value.

setSourceBlock

setSourceBlock(block)

Attach this field to a block.

Parameter
block	The block containing this field. Value must not be null.

Parameter

block

The block containing this field.

Value must not be null.

Inherited from: Blockly.Field#setSourceBlock

setSpellcheck

setSpellcheck(check)

Set whether this field is spellchecked by the browser.

Parameter
check	True if checked.

Inherited from: Blockly.FieldTextInput#setSpellcheck

setText

setText(newText)

Set the text in this field and fire a change event.

Parameter
newText	New text.

Inherited from: Blockly.FieldTextInput#setText

setTooltip

setTooltip(_newTip)

Change the tooltip text for this field.

Parameter
_newTip	Text for tooltip or a parent element to link to for its tooltip.

Inherited from: Blockly.Field#setTooltip

setValidator

setValidator(handler)

Sets a new validation function for editable fields.

Parameter
handler	New validation function, or null.

Inherited from: Blockly.Field#setValidator

setValue

setValue(newValue)

By default there is no difference between the human-readable text and the language-neutral values. Subclasses (such as dropdown) may define this.

Parameter
newValue	New value.

Inherited from: Blockly.Field#setValue

setVisible

setVisible(visible)

Sets whether this editable field is visible or not.

Parameter
visible	True if visible.

Inherited from: Blockly.Field#setVisible

updateEditable

updateEditable()

Add or remove the UI indicating if this field is editable or not.

Inherited from: Blockly.Field#updateEditable

updateWidth

updateWidth()

Updates thw width of the field. This calls getCachedWidth which won't cache the approximated width on IE/Edge when getComputedTextLength fails. Once it eventually does succeed, the result will be cached.

Inherited from: Blockly.Field#updateWidth

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated July 3, 2018.