Campos de identificador

Um campo de rótulo armazena uma string como value e outra como text. Os campos value e text de um campo de rótulo são sempre iguais.

Campo de marcador

Um bloco com duas linhas. O primeiro tem o rótulo "a label" e o segundo tem o rótulo "and another label".

Campo de rótulo no bloco fechado

O mesmo bloco depois de ser recolhido. Ele tem uma única linha, o rótulo "um rótulo e outro rótulo" e uma borda direita irregular para mostrar que ele está reduzido.

Criação

JSON

{
  "type": "example_label",
  "message0": "a label %1 and another label",
  "args0": [
    {
      "type": "input_dummy"
    }
  ]
}

Qualquer texto de mensagem entre argumentos de interpolação se torna strings de rótulo. Como alternativa, os rótulos podem ser interpolados explicitamente, como um objeto ou como texto. Isso geralmente é desencorajado, porque dificulta a tradução.

{
  "type": "example_label",
  "message0": "%1 %2 %3",
  "args0": [
    {
      "type": "field_label",
      "text": "a label"
    },
    {
      "type": "input_dummy"
    },
    "and another label"
  ]
}

JavaScript

Blockly.Blocks['example_label'] = {
  init: function() {
    this.appendDummyInput()
        .appendField(new Blockly.FieldLabel('a label'));
    this.appendDummyInput()
        .appendField('and another label');
  }
};

A função appendField aceita objetos FieldLabel e, mais comumente, strings para criar rótulos.

O campo de rótulo recebe um valor opcional e uma string de classe CSS opcional. O padrão é uma string vazia.

Serialização

Os campos de rótulo não são serializáveis.

Se você quiser que o rótulo seja serializado porque está sendo alterado programaticamente, consulte o campo Rótulo serializável.

Validadores

Os campos de rótulo não são compatíveis com validadores porque não são editáveis.