Giá trị
Tất cả các trường đều phải có giá trị, đây là nguồn thông tin đáng tin cậy cho dữ liệu của trường. Đây có thể là bất kỳ loại nào (chuỗi, số, mảng, ngày, v.v.). Các trường có thể sử dụng trình xác thực để hạn chế giá trị hoặc dịch sang định dạng mà máy có thể đọc được (ví dụ: chuẩn hoá định dạng ngày).
Văn bản
Tất cả các trường đều chứa văn bản, là một chuỗi đơn giản mà con người có thể đọc được, đại diện cho giá trị của trường. Điều này không nhất thiết có nghĩa là chúng giống nhau. Ví dụ: văn bản trên một trường boolean có thể là "Bật" hoặc "Tắt", trong khi giá trị của trường đó là true hoặc false.
Văn bản này sẽ xuất hiện khi khối bị thu gọn, để hỗ trợ tiếp cận và có thể là một phần của nội dung hiển thị trên khối (không bắt buộc).
Trường có thể chỉnh sửa và trường không thể chỉnh sửa
Nhìn chung, các trường có thể chỉnh sửa cho phép người dùng thay đổi mã, trong khi các trường không thể chỉnh sửa sẽ hiển thị thông tin cho người dùng về khối. Các trường có thể chỉnh sửa có thể hiển thị một trình chỉnh sửa đa dạng thức khi bạn nhấp vào.
Các trường có thể chỉnh sửa bao gồm:
Các trường không thể chỉnh sửa bao gồm:
Chuyển đổi tuần tự
Giá trị của trường có thể chuyển đổi tuần tự sẽ được mã hoá ở định dạng lưu (JSON hoặc XML). Tất cả các trường có thể chỉnh sửa đều có thể được chuyển đổi tuần tự vì giá trị của chúng là động. Giá trị của các trường không thể chỉnh sửa thường không phải là giá trị động, nên thường không được chuyển đổi tuần tự.
Các trường được chuyển đổi tuần tự bao gồm:
Các trường không được chuyển đổi tuần tự bao gồm:
Lưu ý rằng bạn không thể chỉnh sửa trường Label Serializable (Nhãn có thể chuyển đổi tuần tự), nhưng có thể chuyển đổi tuần tự. Điều này có nghĩa là bạn chỉ có thể chỉnh sửa theo chương trình chứ không thể thông qua giao diện người dùng mà người dùng nhìn thấy. Sau khi được chỉnh sửa, giá trị của khoá sẽ được mã hoá trong JSON/XML đã tạo.
Tạo mã
Ngoài việc kết nối và ngắt kết nối các khối, các trường là cách duy nhất mà người dùng có thể kiểm soát mã do Blockly tạo. Trình chỉnh sửa do một trường cung cấp cho phép người dùng sửa đổi giá trị do trường lưu trữ. Sau đó, trình tạo khối có thể truy cập vào giá trị của trường để sử dụng trong mã được tạo.
Để biết thêm thông tin về cách sử dụng giá trị của một trường trong trình tạo, hãy xem phần tạo mã trường.
Hiển thị trên khối
Hiển thị trên khối của trường là một tập hợp các phần tử SVG đại diện cho giá trị của trường. Chúng chiếm không gian trên khối và khi thay đổi kích thước, chúng sẽ buộc khối thay đổi kích thước. Màn hình hiển thị trên khối của một trường có thể đơn giản hoặc phức tạp, tuỳ thuộc vào nhu cầu của trường đó.
Sau đây là một số ví dụ về các màn hình hiển thị trên khối, theo thứ tự tăng dần độ phức tạp.
| Loại trường | Mô tả |
|---|---|
| Hãng nhạc | Chỉ chứa một phần tử văn bản. |
| Góc | Chứa một hình chữ nhật nền, phần tử văn bản và biểu tượng độ. |
| Rùa | Chứa một hình chữ nhật nền, phần tử văn bản và nhiều phần tử SVG dùng để tạo hình ảnh đồ hoạ rùa. |
Màn hình của trình chỉnh sửa
Khi người dùng nhấp vào một trường có thể chỉnh sửa, trường đó có thể hiển thị một trình chỉnh sửa phức tạp tuỳ ý.
Sau đây là một số ví dụ về các trình chỉnh sửa, theo thứ tự tăng dần độ phức tạp.
| Loại trường | Mô tả |
|---|---|
| Hộp kiểm | Không có trình chỉnh sửa khi nhấp vào. Màn hình sẽ cập nhật theo khối. |
| Nhập số | Trình chỉnh sửa văn bản được phủ lên trên màn hình hiển thị trên khối. Người dùng có thể nhập; trình chỉnh sửa có thể thay đổi màu để cho biết giá trị không hợp lệ. |
| Bộ chọn góc | Bộ chọn góc có cả trình chỉnh sửa văn bản để nhập số và trình chỉnh sửa có thể kéo để chọn góc một cách trực quan. |
Các chế độ hiển thị khác
Chế độ thu gọn: người dùng thu gọn khối.Khối này hiển thị một bản trình bày văn bản về các giá trị của khối, sử dụng văn bản do các trường riêng lẻ trả về.
Chế độ hỗ trợ tiếp cận: người dùng có thể đang sử dụng trình đọc màn hình hoặc công nghệ tương tự để tương tác với Blockly. Văn bản của trường có thể được đọc cho người dùng.