حقول الأرقام

يخزِّن حقل الأرقام رقمًا بصفته value وسلسلة باعتبارها text. الساعة الآن value عبارة عن رقم صالح دائمًا كما هو محدّد في القيود المفروضة على والحقل عند الإنشاء؛ يمكن أن يكون نصها أي سلسلة يتم إدخالها في المحرر الخاص بها.

حقل أرقام

حقل رقم مع فتح المحرِّر

حقل أرقام في مربّع تم تصغيره

الإنشاء

JSON

{
  "type": "example_number",
  "message0": "number: %1",
  "args0": [
    {
      "type": "field_number",
      "name": "FIELDNAME",
      "value": 100,
      "min": 0,
      "max": 100,
      "precision": 10
    }
  ]
}

JavaScript

Blockly.Blocks['example_number'] = {
  init: function() {
    this.appendDummyInput()
        .appendField("number:")
        .appendField(new Blockly.FieldNumber(100, 0, 100, 10), 'FIELDNAME');
  }
};

تستخدم الدالة الإنشائية للأرقام ما يلي:

• value اختيارية
• الحد الأدنى اختياريًا
• قيمة max اختيارية
• دقة اختيارية
• مدقّق اختياري

يجب تحويل value إلى رقم. وإذا لم يكن 0، فسيتم استخدام 0.

التسلسل

JSON

يبدو ملف JSON لحقل الأرقام كما يلي:

{
  "fields": {
    "FIELDNAME": 0
  }
}

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

XML

يبدو رمز XML لحقل الأرقام كما يلي:

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

تحتوي السمة name للعقدة field على سلسلة تشير إلى رقم وtext الداخلية للعقدة هي value المطلوب تطبيقها على الحقل. تشير رسالة الأشكال البيانية تتبع قيمة النص الداخلية نفس القواعد مثل قيمة الدالة الإنشائية.

القيود

يمكن تعيين القيود في تعريف الحقل، أو باستخدام setConstraints الأخرى.

قيمة الحد الأدنى

تحدّد قيمة min القيمة الأصغر أو الأكثر سالبة التي يُسمح للحقل بها تحتوي عليه.

القيمة القصوى

تحدّد قيمة max القيمة الأكبر/الأكثر إيجابية التي يُسمح للحقل بها تحتوي عليه.

التقريب

تقرِّب precision القيمة إلى أقرب مضاعف للدقة. يمكن أن تظهر فائدة هذا بوضوح أكبر يُستخدم لجعل الحقل يقبل فقط مضاعفات .01، و10، و42، وما إلى ذلك.

القيود الشائعة

الأرقام الموجبة

لفرض قبول الأرقام الموجبة فقط في الحقل، اضبط قيمة min على 1-

الأعداد الصحيحة

لفرض قبول الحقل للأعداد الصحيحة فقط، اضبط السمة precision على 1.

إنشاء مدقق أرقام

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

قيمة حقل الرقم هي رقم، لذلك يجب على أي مدقّقين قبول number عرض number أو null أو undefined

في ما يلي مثال على مدقّق يغيِّر القيمة إلى 0 أو 1 اعتمادًا على ما إذا كانت القيمة فردية أو زوجية.

function(newValue) {
  return newValue % 2;
}