فیلدهای شماره

یک فیلد عددی یک عدد را به عنوان value و یک رشته را به عنوان text خود ذخیره می کند. value آن همیشه یک عدد معتبر است که توسط محدودیت‌های داده شده به فیلد در هنگام ایجاد تعریف می‌شود. متن آن می تواند هر رشته ای باشد که وارد ویرایشگر آن می شود.

فیلد شماره

فیلد شماره با ویرایشگر باز است

فیلد شماره در بلوک جمع شده

ایجاد

JSON

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

جاوا اسکریپت

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

سازنده اعداد موارد زیر را می گیرد:

value باید به یک عدد داده شود. اگر نشد 0 استفاده می شود.

سریال سازی

JSON

فیلد JSON برای یک عدد به این صورت است:

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

جایی که FIELDNAME رشته‌ای است که به فیلد عددی ارجاع می‌دهد و مقدار آن مقداری است که باید به فیلد اعمال شود. مقدار از همان قوانین ارزش سازنده پیروی می کند.

XML

XML فیلد عددی به این صورت است:

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

ویژگی name گره field حاوی رشته ای است که به فیلد عددی ارجاع می دهد و text درونی گره value است که باید به فیلد اعمال شود. مقدار متن داخلی از قوانینی مشابه با مقدار سازنده پیروی می کند.

محدودیت ها

محدودیت ها را می توان در تعریف فیلد یا با استفاده از تابع setConstraints تنظیم کرد.

حداقل ارزش

مقدار min کوچکترین/منفی ترین مقداری را تعیین می کند که فیلد مجاز است حاوی آن باشد.

حداکثر مقدار

max مقدار بزرگ‌ترین/مثبت‌ترین مقداری را که فیلد مجاز به آن است تعیین می‌کند.

گرد کردن

precision مقدار را به نزدیکترین مضرب دقت گرد می کند. این می تواند مورد استفاده قرار گیرد تا فیلد فقط مضرب های 0.01، 10، 42 و غیره را بپذیرد.

محدودیت های مشترک

اعداد مثبت

برای اینکه فیلد خود را مجبور کنید فقط اعداد مثبت را بپذیرد، مقدار min را روی 1 قرار دهید.

اعداد صحیح

برای اینکه فیلد خود را مجبور کنید فقط اعداد صحیح را بپذیرد، precision روی 1 تنظیم کنید.

ایجاد اعتبار سنجی اعداد

مقدار یک فیلد عددی یک عدد است، بنابراین هر اعتبارسنجی باید یک number بپذیرد و یک number ، null یا undefined برگرداند.

در اینجا نمونه ای از اعتبارسنجی است که بسته به فرد یا زوج بودن مقدار، مقدار را به 0 یا 1 تغییر می دهد.

function(newValue) {
  return newValue % 2;
}