حقول إدخال النص

يخزن حقل إدخال النص سلسلة كقيمتها وسلسلة كنص لها. من أن تكون دائمًا سلسلة صالحة، في حين يمكن أن يكون نصها أي سلسلة تم إدخالها في ومحرره.

حقل إدخال النص

حقل إدخال النص مع فتح المحرِّر

حقل إدخال النص على جزء صغير

الإنشاء

JSON

{
  "type": "example_textinput",
  "message0": "text input: %1",
  "args0": [
    {
      "type": "field_input",
      "name": "FIELDNAME",
      "text": "default text",
      "spellcheck": false
    }
  ]
}

JavaScript

Blockly.Blocks['example_textinput'] = {
  init: function() {
    this.appendDummyInput()
        .appendField("text input:")
        .appendField(new Blockly.FieldTextInput('default text'),
            'FIELDNAME');
  }
};

تستخدم الدالة الإنشائية لإدخال النص قيمة اختيارية ودالة اختيارية مدقق. يجب تحويل القيمة إلى السلسلة. وإذا كانت القيمة null أو undefined، سيتم استخدام سلسلة فارغة.

يتيح لك تعريف JSON أيضًا ضبط خيار التدقيق الإملائي.

التسلسل وXML

JSON

يبدو رمز JSON لحقل إدخال النص كما يلي:

{
  "fields": {
    "FIELDNAME": "text"
  }
}

عندما تكون FIELDNAME عبارة عن سلسلة تشير إلى حقل إدخال نص، تكون القيمة هي القيمة المراد تطبيقها على الحقل. القيمة ويتبع نفس القواعد مثل قيمة الدالة الإنشائية.

XML

يبدو تنسيق XML لحقل إدخال النص كما يلي:

<field name="FIELDNAME">text</field>

عندما تحتوي سمة name في الحقل على سلسلة تشير إلى إدخال نص والنص الداخلي هو القيمة التي يجب تطبيقها على الحقل. الجزء الداخلي نفس القواعد مثل قيمة الدالة الإنشائية.

التخصيص

التدقيق الإملائي

تشير رسالة الأشكال البيانية setSpellcheck لتحديد ما إذا كان الحقل يقوم بالتدقيق الإملائي لنص الإدخال أم لا.

حقول إدخال النصوص مع التدقيق الإملائي وبدونه

يكون التدقيق الإملائي مفعّلاً بشكل تلقائي.

ينطبق ذلك على الحقول الفردية. إذا كنت تريد تعديل جميع الحقول، يمكنك تغيير الموقع: Blockly.FieldTextInput.prototype.spellcheck_.

جارٍ إنشاء أداة التحقّق من صحة إدخال النص

ملاحظة: للحصول على معلومات حول أدوات التحقّق بشكل عام، يُرجى مراجعة أداة التحقّق من الصحة.

قيمة حقل إدخال النص هي سلسلة، لذلك يجب أن تقبل أي مدقّقين سلسلة. وتُرجع السلسلة، null أو undefined.

في ما يلي مثال على مدقّق يزيل جميع أحرف 'a' من الأحرف string:

function(newValue) {
  return newValue.replace(/a/g, '');
}