Giá trị
Tất cả các trường đều bắt buộc phải có giá trị. Giá trị này là nguồn đáng tin cậy cho dữ liệu của trường. Chuỗi này có thể thuộc 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 để giới hạn các giá trị hoặc dịch sang một đị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. Đây 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 phải lúc nào cũng giống nhau. Ví dụ: văn bản trên trường boolean có thể là "On" (Bật) hoặc "Off" (Tắt), trong khi giá trị của văn bản đó là "true" hoặc "false".
Văn bản này là nội dung hiển thị khi khối được thu gọn, để hỗ trợ tiếp cận và có thể là một phần của màn hình 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 sửa đổi mã, còn các trường không thể chỉnh sửa sẽ cho người dùng thấy thông tin về khối. Các trường có thể chỉnh sửa có thể hiển thị trình chỉnh sửa đa dạng thức khi được 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 chuyển đổi tuần tự đượ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ể chuyển đổi tuần tự vì giá trị của các trường đó là động. Giá trị của các trường không thể chỉnh sửa thường không động, vì vậy, các giá trị này thường không được chuyển đổi tuần tự.
Các trường theo tuần tự bao gồm:
Các trường không chuyển đổi tuần tự bao gồm:
Lưu ý: Bạn không thể chỉnh sửa trường Nhãn theo tuần tự nhưng có thể chuyển đổi tuần tự được. Điều này có nghĩa là bạn chỉ có thể chỉnh sửa tệp theo phương thức lập trình thay vì thông qua giao diện người dùng hiển thị cho người dùng. Sau khi chỉnh sửa, giá trị của thông số này đượ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, trường là cách duy nhất để 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ị mà trường đó lưu trữ. Sau đó, trình tạo của 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 nội dung tạo mã trường.
Hiển thị trên khối
Màn hình trên khối của một trường là một tập hợp các phần tử SVG biểu thị 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. Chế độ 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.
Dưới đây là một số ví dụ về nhiều loại màn hình trên khối, theo thứ tự tăng độ phức tạp.
| Loại trường | Nội dung mô tả |
|---|---|
| Nhãn | Chỉ chứa một phần tử văn bản. |
| Góc | Chứa hình chữ nhật nền, phần tử văn bản và biểu tượng độ. |
| Rùa | Chứa 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 rùa. |
Màn hình 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ị trình chỉnh sửa phức tạp tuỳ ý.
Dưới đây là một số ví dụ về các trình chỉnh sửa khác nhau, theo thứ tự tăng độ phức tạp.
| Loại trường | Nội dung mô tả |
|---|---|
| Hộp đánh dấu | Không có trình chỉnh sửa khi nhấp vào. Thông tin cập nhật về màn hình trên khối. |
| Nhập số | Trình chỉnh sửa văn bản được phủ lên phía trên màn hình trên khối. Người dùng có thể nhập; trình chỉnh sửa có thể thay đổi màu để biểu thị các 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ị bản trình bày bằng văn bản cho các giá trị của nó, sử dụng văn bản do từng trường riêng lẻ trả về.
Chế độ hỗ trợ tiếp cận: người dùng có thể 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. Người dùng có thể đọc to văn bản của trường này.