文本输入字段

文本输入字段将字符串存储为值,并将字符串存储为文本。其值始终为有效字符串,而其文本可以是输入到其编辑器中的任何字符串。

文本输入字段

一个标签为“text input:”的块,以及一个设置为“default text”的文本输入字段。

打开编辑器后的文本输入字段

正在编辑的字段所在的同一块。

折叠块上的文本输入字段

折叠后的同一代码块。它带有“文本输入:默认文本”标签,右边缘呈锯齿状,表示它处于收起状态。

创建

JSON

{
  "type": "example_textinput",
  "message0": "text input: %1",
  "args0": [
    {
      "type": "field_input",
      "name": "FIELDNAME",
      "text": "default text",
      "spellcheck": false
    }
  ]
}

JavaScript

Blockly.Blocks['example_textinput'] = {
  init: function() {
    this.appendDummyInput()
        .appendField("text input:")
        .appendField(new Blockly.FieldTextInput('default text'),
            'FIELDNAME');
  }
};

文本输入构造函数接受一个可选值和一个可选的验证器。该值应转换为字符串。如果值为 nullundefined,则使用空字符串。

您还可以通过 JSON 定义设置 spellcheck 选项。

序列化和 XML

JSON

文本输入字段的 JSON 如下所示:

{
  "fields": {
    "FIELDNAME": "text"
  }
}

其中,FIELDNAME 是引用文本输入字段的字符串,而值是要应用于该字段的值。该值遵循与构造函数值相同的规则。

XML

文本输入字段的 XML 如下所示:

<field name="FIELDNAME">text</field>

其中,字段的 name 属性包含引用文本输入字段的字符串,而内部文本是要应用于字段的值。内部文本值遵循与构造函数值相同的规则。

自定义

拼写检查

setSpellcheck 函数可用于设置字段是否对输入文本进行拼写检查。

带拼写检查和不带拼写检查的文本输入字段

一个动画 GIF,显示两个带有文本输入字段的块。第一个块启用了拼写检查功能,拼写错误的字词会以红色波浪线标注。第二个块的拼写检查功能处于关闭状态,拼写错误的字词不会加下划线。

拼写检查功能默认处于开启状态。

这适用于各个字段。如果您想修改所有字段,请更改 Blockly.FieldTextInput.prototype.spellcheck_ 属性。

创建文本输入验证器

文本输入字段的值是一个字符串,因此任何验证器都必须接受字符串并返回字符串、nullundefined

以下是一个验证器的示例,该验证器会从字符串中移除所有 a 字符:

function(newValue) {
  return newValue.replace(/a/g, '');
}

一个动画 GIF,显示正在验证的文本输入字段。当用户输入“bbbaaa”并点击其他位置时,该字段会更改为“bbb”。