Trường số

Trường số lưu trữ một số dưới dạng value và một chuỗi dưới dạng text. value của nó luôn là một số hợp lệ như được xác định bởi các quy tắc ràng buộc được cung cấp cho trường tại thời điểm tạo; văn bản của trường này có thể là bất kỳ chuỗi nào được nhập vào trình chỉnh sửa.

Trường số

Trường số với trình chỉnh sửa đang mở

Trường số trên khối đã thu gọn

dựa trên xu hướng

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

Hàm khởi tạo số nhận các tham số sau:

• value không bắt buộc
• min không bắt buộc
• max không bắt buộc
• độ chính xác không bắt buộc
• trình xác thực không bắt buộc

value phải truyền sang một số. Nếu không, hệ thống sẽ sử dụng giá trị 0.

Chuyển đổi tuần tự

JSON

JSON cho trường số có dạng như sau:

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

Trong đó FIELDNAME là một chuỗi tham chiếu đến trường số và giá trị là giá trị cần áp dụng cho trường đó. Giá trị này tuân theo các quy tắc giống như giá trị hàm khởi tạo.

XML

Mã XML cho trường số có dạng như sau:

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

Thuộc tính name của nút field chứa một chuỗi tham chiếu đến một trường số và text bên trong của nút là value để áp dụng cho trường đó. Giá trị văn bản bên trong tuân theo các quy tắc tương tự như giá trị hàm khởi tạo.

Giới hạn

Bạn có thể đặt các quy tắc ràng buộc trong phần định nghĩa trường hoặc bằng cách sử dụng hàm setConstraints.

Giá trị tối thiểu

Giá trị min đặt giá trị nhỏ nhất/âm nhất mà trường được phép chứa.

Giá trị tối đa

Giá trị max đặt giá trị lớn nhất/dương nhất mà trường được phép chứa.

Làm tròn

precision làm tròn giá trị đến bội số gần nhất của độ chính xác. Bạn có thể sử dụng thuộc tính này để chỉ cho phép trường chấp nhận các bội số của 0,01, 10, 42, v .v.

Các quy tắc ràng buộc phổ biến

Số dương

Để buộc trường của bạn chỉ chấp nhận số dương, hãy đặt giá trị min thành 1.

Số nguyên

Để buộc trường của bạn chỉ chấp nhận số nguyên, hãy đặt precision thành 1.

Tạo trình xác thực số

Lưu ý: Để biết thông tin chung về trình xác thực, hãy xem bài viết Trình xác thực.

Giá trị của trường số là một số, vì vậy, mọi trình xác thực đều phải chấp nhận number và trả về number, null hoặc undefined.

Dưới đây là ví dụ về trình xác thực thay đổi giá trị thành 0 hoặc 1 tuỳ thuộc vào việc giá trị đó là số lẻ hay số chẵn.

function(newValue) {
  return newValue % 2;
}