Le etichette serializzabili funzionano esattamente come le etichette normali ad eccezione del fatto che sono anche serializzati in XML. Dovrebbero essere usati solo se modifichi i contenuti di un'etichetta in modo programmatico e si desidera serializzare in XML.
Campo Etichetta serializzabile
Campo dell'etichetta serializzabile in un blocco compresso
Creazione
JSON
{
"type": "example_serializable_label",
"message0": "%1",
"args0": [
{
"type": "field_label_serializable",
"name": "FIELDNAME",
"text": "a serializable label"
}
]
}
JavaScript
Blockly.Blocks['example_serializable_label'] = {
init: function() {
this.appendDummyInput()
.appendField(new Blockly.FieldLabelSerializable("a serializable label"), "FIELDNAME");
}
};
Il campo dell'etichetta serializzabile contiene un valore facoltativo e un CSS facoltativo stringa di classe. Per entrambe le impostazioni è impostata una stringa vuota.
Serializzazione
JSON
Il JSON per un campo di etichetta serializzabile ha il seguente aspetto:
{
"fields": {
"FIELDNAME": text
}
}
dove FIELDNAME
è una stringa che fa riferimento a un campo di etichetta serializzabile e
il valore è il valore da applicare al campo. Il valore
segue le stesse regole del valore del costruttore.
XML
Il codice XML per un campo di etichetta serializzabile ha il seguente aspetto:
<field name="FIELDNAME">text</field>
L'attributo name
del nodo field
contiene una stringa che fa riferimento a un modello serializzabile
etichetta e il testo interno del nodo è il valore da applicare al campo.
Strumenti di convalida
I campi delle etichette serializzabili non supportano gli strumenti di convalida, in quanto non sono modificabili da un utente.