Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In einem Texteingabefeld wird ein String als Wert und ein String als Text gespeichert. Der Wert ist immer ein gültiger String, während der Text ein beliebiger String sein kann, der in den Editor eingegeben wird.
Der Konstruktor für die Texteingabe nimmt einen optionalen Wert und einen optionalen Validator an. Der Wert muss in einen String umgewandelt werden. Wenn der Wert null oder undefined ist, wird ein leerer String verwendet.
In der JSON-Definition können Sie auch die Option Rechtschreibprüfung festlegen.
Serialisierung und XML
JSON
Das JSON für ein Textfeld sieht so aus:
{"fields":{"FIELDNAME":"text"}}
Dabei ist FIELDNAME ein String, der auf ein Texteingabefeld verweist, und „value“ ist der Wert, der auf das Feld angewendet werden soll. Für den Wert gelten dieselben Regeln wie für den Konstruktorwert.
XML
Die XML-Datei für ein Textfeld sieht so aus:
<fieldname="FIELDNAME">text</field>
Das name-Attribut des Felds enthält einen String, der auf ein Texteingabefeld verweist. Der innere Text ist der Wert, der auf das Feld angewendet werden soll. Für den inneren Text gelten dieselben Regeln wie für den Konstruktorwert.
Anpassung
Rechtschreibprüfung
Mit der Funktion setSpellcheck können Sie festlegen, ob der Eingabetext des Felds automatisch korrigiert werden soll.
Texteingabefelder mit und ohne Rechtschreibprüfung
Die Rechtschreibprüfung ist standardmäßig aktiviert.
Das gilt für einzelne Felder. Wenn Sie alle Felder ändern möchten, ändern Sie die Property Blockly.FieldTextInput.prototype.spellcheck_.
Validierungstool für Texteingaben erstellen
Der Wert eines Textfelds ist ein String. Alle Validatoren müssen also einen String akzeptieren und einen String, null oder undefined zurückgeben.
Hier ein Beispiel für einen Validator, der alle Zeichen „a“ aus dem String entfernt:
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\u003cp\u003eA text input field stores a string value and allows user text input, with the value always being a valid string.\u003c/p\u003e\n"],["\u003cp\u003eYou can create text input fields using JSON or JavaScript, customizing them with options like spellcheck and validators.\u003c/p\u003e\n"],["\u003cp\u003eText input fields can be serialized and deserialized using JSON or XML, representing the field name and value.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esetSpellcheck\u003c/code\u003e function allows control over individual field spellchecking, while \u003ccode\u003eBlockly.FieldTextInput.prototype.spellcheck_\u003c/code\u003e affects all fields.\u003c/p\u003e\n"],["\u003cp\u003eValidators for text input fields accept a string and return a modified string, null, or undefined to enforce specific input rules.\u003c/p\u003e\n"]]],["Text input fields store a string as both their value and text, with the value always being a valid string. Creation involves defining the field in JSON or JavaScript, specifying a default text and optional spellcheck. The constructor and JSON allow setting a value, defaulting to an empty string if `null` or `undefined`. Serialization uses JSON and XML, where field names and values are stored. Spellcheck can be toggled, and validators are functions that accept and return strings, `null`, or `undefined`.\n"],null,["# Text input fields\n\nA text input field stores a string as its value and a string as its text. Its\nvalue is always a valid string, while its text could be any string entered into\nits editor.\n\n#### Text input field\n\n#### Text input field with editor open\n\n#### Text input field on collapsed block\n\nCreation\n--------\n\n### JSON\n\n {\n \"type\": \"example_textinput\",\n \"message0\": \"text input: %1\",\n \"args0\": [\n {\n \"type\": \"field_input\",\n \"name\": \"FIELDNAME\",\n \"text\": \"default text\",\n \"spellcheck\": false\n }\n ]\n }\n\n### JavaScript\n\n Blockly.Blocks['example_textinput'] = {\n init: function() {\n this.appendDummyInput()\n .appendField(\"text input:\")\n .appendField(new Blockly.FieldTextInput('default text'),\n 'FIELDNAME');\n }\n };\n\nThe text input constructor takes in an optional value and an optional\n[validator](#creating_a_text_input_validator). The value should cast to a\nstring. If it is `null` or `undefined`, an empty string will be used.\n\nThe JSON definition also allows you to set the [spellcheck](#spellcheck) option.\n\nSerialization and XML\n---------------------\n\n### JSON\n\nThe JSON for a text input field looks like so: \n\n {\n \"fields\": {\n \"FIELDNAME\": \"text\"\n }\n }\n\nWhere `FIELDNAME` is a string referencing a text input field, and\nthe value is the value to apply to the field. The value\nfollows the same rules as the constructor value.\n\n### XML\n\nThe XML for a text input field looks like so: \n\n \u003cfield name=\"FIELDNAME\"\u003etext\u003c/field\u003e\n\nWhere the field's `name` attribute contains a string referencing a text input\nfield, and the inner text is the value to apply to the field. The inner\ntext value follows the same rules as the constructor value.\n\nCustomization\n-------------\n\n### Spellcheck\n\nThe\n[setSpellcheck](/blockly/reference/js/Blockly.FieldTextInput#setSpellcheck)\nfunction can be used to set whether the field spellchecks its input text or not.\n\n### Text input fields with and without spellcheck\n\nSpellchecking is on by default.\n\nThis applies to individual fields. If you want to modify all fields change the\n`Blockly.FieldTextInput.prototype.spellcheck_` property.\n\nCreating a text input validator\n-------------------------------\n\n| **Note:** For information on validators in general see [Validators](/blockly/guides/create-custom-blocks/fields/validators).\n\nA text input field's value is a string, so any validators must accept a string\nand return a string, `null`, or `undefined`.\n\nHere is an example of a validator that removes all 'a' characters from the\nstring: \n\n function(newValue) {\n return newValue.replace(/a/g, '');\n }"]]
