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

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

حقل إدخال نص

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

حقل إدخال نص في الكتلة المصغّرة

الإنشاء

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" من السلسلة التالية:

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