Champs de libellé

Un champ de libellé stocke une chaîne en tant que value et une chaîne en tant que text. Les valeurs value et text d'un champ de libellé sont toujours identiques.

Champ de libellé

Champ de libellé sur le bloc réduit

Création

JSON

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

Tout texte de message entre les arguments d'interpolation devient des chaînes d'étiquettes. Les étiquettes peuvent également être interpolées explicitement, en tant qu'objet ou sous forme de texte. Cette pratique est généralement déconseillée, car elle rend la traduction plus difficile.

{
  "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');
  }
};

La fonction appendField accepte à la fois les objets FieldLabel et, le plus souvent, des chaînes pour créer des libellés.

Le champ de libellé accepte une valeur et une chaîne de classe CSS (facultatives). Dans les deux cas, une chaîne vide est utilisée par défaut.

sérialisation

Les champs de libellé ne sont pas sérialisables.

Si vous souhaitez que votre étiquette soit sérialisée, car elle est modifiée de manière automatisée, consultez le champ Serializable Label (Libellé sérialisable).

Outils de validation

Les champs de libellé ne sont pas compatibles avec les outils de validation, car ils ne sont pas modifiables.