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

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

فیلد شماره

یک بلوک با برچسب "number:" و یک فیلد عدد تنظیم شده است 100.

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

همان بلوک با میدان بودن ویرایش شده است.

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

همان بلوک پس از فروریختن. دارای برچسب "شماره: 100" و a لبه سمت راست دندانه دار برای نشان دادن آن است فرو ریخت.

خلقت

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;
}

یک GIF متحرک که اعتبار دهنده را در حال کار نشان می دهد. زمانی که کاربر 10 و در جاهای دیگر کلیک می کند، فیلد روی 0 تنظیم می شود. وقتی کاربر 11 را تایپ کرده و کلیک می کند در جای دیگر، فیلد روی 1 تنظیم شده است.