Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Kolom input teks menyimpan string sebagai nilainya dan string sebagai teksnya. Nilainya
selalu berupa string yang valid, sedangkan teksnya dapat berupa string apa pun yang dimasukkan ke dalam
editornya.
Konstruktor input teks menggunakan nilai opsional dan
validator opsional. Nilai harus ditransmisikan ke
string. Jika null atau undefined, string kosong akan digunakan.
Definisi JSON juga memungkinkan Anda menetapkan opsi pemeriksaan ejaan.
Serialisasi dan XML
JSON
JSON untuk kolom input teks terlihat seperti ini:
{"fields":{"FIELDNAME":"text"}}
Dengan FIELDNAME adalah string yang mereferensikan kolom input teks, dan
nilai adalah nilai yang akan diterapkan ke kolom. Nilai ini
mengikuti aturan yang sama dengan nilai konstruktor.
XML
XML untuk kolom input teks terlihat seperti ini:
<fieldname="FIELDNAME">text</field>
Dengan atribut name kolom berisi string yang mereferensikan kolom input
teks, dan teks dalam adalah nilai yang akan diterapkan ke kolom. Nilai teks
dalam mengikuti aturan yang sama dengan nilai konstruktor.
Penyesuaian
Periksa ejaan
Fungsi
setSpellcheck
dapat digunakan untuk menetapkan apakah kolom akan memeriksa ejaan teks inputnya atau tidak.
Kolom input teks dengan dan tanpa periksa ejaan
Pemeriksaan ejaan aktif secara default.
Hal ini berlaku untuk setiap kolom. Jika Anda ingin mengubah semua kolom, ubah properti Blockly.FieldTextInput.prototype.spellcheck_.
Membuat validator input teks
Nilai kolom input teks adalah string, sehingga setiap validator harus menerima string
dan menampilkan string, null, atau undefined.
Berikut adalah contoh validator yang menghapus semua karakter 'a' dari
string:
[null,null,["Terakhir diperbarui pada 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 }"]]
