Переменные поля

Поле переменной хранит строку в качестве значения и строку в качестве текста. Значение представляет собой идентификатор переменной, а текст — имя переменной.

Переменное поле

Поле переменной с открытым редактором

Переменное поле в свернутом блоке

Создание

Нетипизированный

JSON

{
  "type": "example_variable_untyped",
  "message0": "variable: %1",
  "args0": [
    {
      "type": "field_variable",
      "name": "FIELDNAME",
      "variable": "x"
    }
  ]
}

JavaScript

Blockly.Blocks['example_variable_untyped'] = {
  init: function() {
    this.appendDummyInput()
        .appendField('variable:')
        .appendField(new Blockly.FieldVariable('x'), 'FIELDNAME');
  }
};

Напечатано

JSON

{
  "type": "example_variable_typed",
  "message0": "variable: %1",
  "args0": [
    {
      "type": "field_variable",
      "name": "FIELDNAME",
      "variable": "x",
      "variableTypes": ["Number", "String"],
      "defaultType": "Number"
    }
  ]
}

JavaScript

Blockly.Blocks['example_variable_typed'] = {
  init: function() {
    this.appendDummyInput()
      .appendField('variable:')
      .appendField(new Blockly.FieldVariable(
          'X',
          null,
          ['Number', 'String'],
          'Number'
      ), 'FIELDNAME');
  }
};

Конструктор переменных принимает необязательное имя переменной, необязательный валидатор , необязательный массив типов переменных и необязательный тип по умолчанию.

  • Имя переменной должно быть строкой. Это будет имя начальной переменной, содержащейся в поле. Если оно равно нулю или не определено, будет сгенерировано уникальное имя.
  • Типы переменных должны представлять собой массив строк. Это сообщает полю, какие типы переменных оно может содержать (т. е. какие типы переменных следует добавить в раскрывающийся список). Если оно равно нулю или не определено, все типы переменных будут приняты (и добавлены в раскрывающийся список).
  • Тип по умолчанию должен быть строкой. Это будет использоваться при создании исходной переменной модели месторождения. Если это определено, его следует включить в массив типов переменных. Если оно равно нулю или не определено, это значение по умолчанию равно пустой строке, что означает, что начальная переменная будет гибко типизирована.

→ Дополнительную информацию о строгой типизации см. в разделе «Проверка типов» .

Сериализация

JSON

JSON для переменного поля выглядит так:

{
  "fields": {
    "FIELDNAME": {
      "id": "QJD^+@[RVIwbLSZoDb:V"
    }
  }
}

Где FIELDNAME — это строка, ссылающаяся на поле переменной, а значение — это идентификатор переменной, на которую ссылается это поле.

Если вы используете это поле на панели инструментов, вы также можете указать имя и (необязательно) тип напрямую, поскольку не будет никакой переменной, доступной для ссылки.

{
  "fields": {
    "FIELDNAME": {
      "name": "my_variable",
      "type": "string"
    }
  }
}

XML

XML для поля переменной выглядит так:

<field name="VARIABLE" id="QJD^+@[RVIwbLSZoDb:V" variabletype="">name</field>
  • Атрибут name узла содержит строку, ссылающуюся на переменное поле.
  • Атрибут id узла содержит идентификатор переменной, на которую ссылается поле.
  • Атрибут variabletype узла содержит тип переменной. variabletype следует тем же правилам, что и параметр типа по умолчанию конструктора.
  • Внутренний текст узла — это имя переменной. Внутреннее текстовое значение подчиняется тем же правилам, что и параметр имени переменной конструктора.

Создание валидатора переменных

Значением переменного поля является строка, поэтому любые валидаторы должны принимать строку и возвращать строку, null или undefined .

Вот пример валидатора, который принимает в качестве опций только некоторые предопределенные переменные. Эти переменные необходимо будет определить с помощью функции Workspace.createVariable при загрузке рабочей области.

function(newValue) {
  var validIds = ['Worf', 'Riker', 'Picard'];
  if (validIds.indexOf(newValue) == -1) {
    return null;
  }
  return newValue;
}