Chèn
Bạn có thể chèn một không gian làm việc Blockly bằng lệnh gọi đến Blockly.inject(location, options). Đối số đầu tiên cho Blockly biết vị trí chèn không gian làm việc trong DOM. Đối số thứ hai là một từ điển chứa các cặp tên-giá trị dùng để định cấu hình. Mã chèn phân tích cú pháp từ điển tuỳ chọn thành một thực thể của Blockly.Options.
Tạo trực tiếp
Bạn cũng có thể tạo không gian làm việc trực tiếp bằng cách gọi Blockly.WorkspaceSvg(new Blockly.Options(options)). Xin lưu ý rằng bạn cần gọi new Blockly.Options(options), truyền vào từ điển tuỳ chọn – hàm khởi tạo không gian làm việc dự kiến một thực thể của Blockly.Options, chứ không phải một từ điển tuỳ chọn trần.
Từ điển tuỳ chọn
Các tuỳ chọn sau được hỗ trợ. Xin lưu ý rằng một số tuỳ chọn trong số này sẽ thay đổi giá trị mặc định dựa trên việc hộp công cụ được cung cấp có danh mục hay không.
| Tên | Loại | Mô tả |
|---|---|---|
collapse
|
boolean | Cho phép thu gọn hoặc mở rộng các khối. Mặc định là true nếu hộp công cụ có danh mục, nếu không thì là false. |
comments
|
boolean | Cho phép các khối có bình luận. Mặc định là true nếu hộp công cụ có các danh mục,false nếu không. |
css
|
boolean | Nếu giá trị là false, đừng chèn CSS (cung cấp CSS sẽ là trách nhiệm của tài liệu). Giá trị mặc định là true. |
disable
|
boolean | Cho phép tắt các khối. Mặc định là true nếu hộp công cụ có các danh mục, nếu không thì là false. |
grid |
đối tượng | Định cấu hình lưới mà các khối có thể chụp nhanh. Xem phần Lưới. |
horizontalLayout
|
boolean | Nếu hộp công cụ true nằm ngang, nếu hộp công cụ false nằm dọc. Mặc định là false. |
maxBlocks
|
số | Số lượng khối tối đa có thể tạo. Hữu ích cho bài tập của học viên. Giá trị mặc định là Infinity. |
maxInstances
|
đối tượng | Liên kết từ các loại khối đến số lượng khối tối đa của loại khối đó có thể được tạo. Các loại chưa khai báo mặc định là Infinity. Ví dụ:
maxInstances: {'controls_if': 3, 'math_number': 42} |
media
|
chuỗi | Đường dẫn từ trang (hoặc khung) đến thư mục nội dung nghe nhìn của Blockly.
Giá trị mặc định là "https://blockly-demo.appspot.com/static/media/". |
move
|
đối tượng | Định cấu hình hành vi cho cách người dùng có thể di chuyển trong không gian làm việc. Xem phần Di chuyển. |
oneBasedIndex
|
boolean | Nếu các thao tác danh sách và chuỗi true phải lập chỉ mục từ 1, nếu false lập chỉ mục từ 0. Giá trị mặc định là true. |
readOnly
|
boolean | Nếu là true, hãy ngăn người dùng chỉnh sửa. Bỏ qua hộp công cụ và thùng rác. Giá trị mặc định là false. |
renderer
|
chuỗi | Xác định trình kết xuất mà blockly sử dụng. Các trình kết xuất được đóng gói sẵn bao gồm "geras" (mặc định), "thrasos" và "zelos" (một trình kết xuất giống như scratch). |
rtl
|
boolean | Nếu là true, hãy phản chiếu trình chỉnh sửa (đối với ngôn ngữ Ả Rập hoặc tiếng Do Thái).
Xem bản minh hoạ RTL. Mặc định là false. |
scrollbars
|
đối tượng hoặc boolean | Đặt xem không gian làm việc có thanh cuộn dọc hay ngang. Lấy một đối tượng trong đó thuộc tính horizontal xác định xem tính năng cuộn theo chiều ngang có được bật hay không và thuộc tính vertical xác định xem tính năng cuộn theo chiều dọc có được bật hay không. Nếu truyền một boolean, thì thao tác này tương đương với việc truyền một đối tượng có cả thuộc tính horizontal và vertical được đặt thành giá trị đó. Mặc định là true nếu hộp công cụ có các danh mục. |
sounds |
boolean | Nếu là false, hãy tắt âm thanh. Giá trị mặc định là true. |
theme
|
Chủ đề | Mặc định là giao diện cổ điển nếu không có giao diện nào được cung cấp. Xem phần Chủ đề. |
toolbox
|
chuỗi, XML hoặc JSON | Cấu trúc cây của các danh mục và khối có sẵn cho người dùng. Hãy xem phần xác định hộp công cụ để biết thêm thông tin. |
toolboxPosition
|
chuỗi | Nếu hộp công cụ "start" ở trên cùng (nếu theo chiều ngang) hoặc bên trái (nếu theo chiều dọc và LTR) hoặc bên phải (nếu theo chiều dọc và RTL). Nếu hộp công cụ "end" ở phía đối diện. Mặc định là "start". |
trashcan
|
boolean | Hiện hoặc ẩn thùng rác. Mặc định là true nếu hộp công cụ có các danh mục, nếu không thì là false. |
maxTrashcanContents
|
số | Số lượng mục đã xoá tối đa sẽ xuất hiện trong trình đơn bật lên thùng rác. "0" sẽ tắt tính năng này. Giá trị mặc định là "32". |
plugins
|
đối tượng | Liên kết loại trình bổ trợ với tên của trình bổ trợ hoặc lớp trình bổ trợ đã đăng ký. Xem phần chèn lớp con. |
zoom |
đối tượng | Định cấu hình hành vi thu phóng. Xem phần Thu phóng. |