数字字段存储数字作为其 value
,将字符串存储为 text
。其 value
始终是一个有效数字,由创建字段时为其提供的限制条件定义;其文本可以是输入其编辑器中的任何字符串。
数字字段
已打开编辑器的数字字段
收起块上的数字字段
恣意创作
JSON
{
"type": "example_number",
"message0": "number: %1",
"args0": [
{
"type": "field_number",
"name": "FIELDNAME",
"value": 100,
"min": 0,
"max": 100,
"precision": 10
}
]
}
JavaScript
Blockly.Blocks['example_number'] = {
init: function() {
this.appendDummyInput()
.appendField("number:")
.appendField(new Blockly.FieldNumber(100, 0, 100, 10), 'FIELDNAME');
}
};
数字构造函数会接受以下内容:
value
应转换为数字。如果它不为 0,则使用该值。
序列化
JSON
数字字段的 JSON 如下所示:
{
"fields": {
"FIELDNAME": 0
}
}
其中,FIELDNAME
是一个引用数字字段的字符串,而值是要应用于该字段的值。该值遵循的规则与构造函数值相同。
XML
数字字段的 XML 如下所示:
<field name="FIELDNAME">0</field>
field
节点的 name
属性包含一个引用数字字段的字符串,节点的内部 text
是要应用于该字段的 value
。内部文本值遵循与构造函数值相同的规则。
约束条件
您可以在字段定义中设置限制条件,也可以使用 setConstraints 函数。
最小值
min
值用于设置字段允许包含的最小/最负值。
最大值
max
值用于设置字段允许包含的最大/最正值。
舍入
precision
会将值四舍五入为最接近的精度倍数。这可用于使字段仅接受 .01、10、42 等的倍数。
常见限制条件
正数
如需强制字段仅接受正数,请将 min
值设置为 1。
Integers
如需强制字段仅接受整数,请将 precision
设置为 1。
创建数字验证器
数字字段的值是一个数字,因此任何验证器都必须接受 number
并返回 number
、null
或 undefined
。
以下是一个验证器示例,该验证程序根据值为奇数还是偶数将值更改为 0 或 1。
function(newValue) {
return newValue % 2;
}