Bạn có thể tạo một không gian làm việc và chèn không gian đó vào DOM trong một lệnh gọi duy nhất hoặc chỉ tạo một không gian làm việc.
Tiêm
Bạn có thể tạo một không gian làm việc Blockly và chèn không gian đó vào DOM bằng một 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 đối tượng chứa các lựa chọn cấu hình.
Để biết thêm thông tin, hãy xem phần Tạo không gian làm việc.
Tạo trực tiếp
Bạn có thể tạo một không gian làm việc trực tiếp bằng cách gọi new Blockly.WorkspaceSvg(new
Blockly.Options(options)). Khi thực hiện lệnh gọi này, hãy nhớ truyền các lựa chọn cấu hình trong lệnh gọi đến new Blockly.Options(options) – hàm khởi tạo WorkspaceSvg không thể chấp nhận trực tiếp đối tượng lựa chọn cấu hình của bạn.
Các lựa chọn về cấu hình
Đối tượng cấu hình triển khai Blockly.BlocklyOptions và có các lựa chọn sau. Xin lưu ý rằng một số lựa chọn trong số này sẽ thay đổi giá trị mặc định tuỳ thuộc vào 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 | Liệu menu ngữ cảnh của khối có bao gồm một mục để thu gọn hoặc mở rộng các khối hay không. Mặc định là true nếu hộp công cụ có danh mục, false nếu không. |
comments |
boolean | Liệu các trình đơn theo bối cảnh của khối có bao gồm một mục để thêm hoặc xoá bình luận hay không. Mặc định là true nếu hộp công cụ có danh mục,false nếu không. |
css |
boolean | Nếu là false, đừng chèn CSS (việc cung cấp CSS sẽ thuộc trách nhiệm của tài liệu). Giá trị mặc định là true. |
disable |
boolean | Cho dù trình đơn theo ngữ cảnh của khối có chứa một mục để tắt hoặc bật khối hay không. Mặc định là true nếu hộp công cụ có danh mục, false nếu không. |
grid |
đối tượng | Định cấu hình một lưới mà các khối có thể gắn vào. Xem phần Lưới. |
horizontalLayout |
boolean | Nếu hộp công cụ true có dạng ngang, nếu hộp công cụ false có dạng 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 các bài tập của học viên. Giá trị mặc định là Infinity. |
maxInstances |
đối tượng | Ánh xạ từ các loại khối đến số lượng khối tối đa của loạ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} |
maxTrashcanContents |
số | Số lượng tối đa các mục đã xoá sẽ xuất hiện trong trình đơn di chuột thùng rác. '0' sẽ tắt tính năng này. Giá trị mặc định là '32'. |
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/'. Xem phần Thư mục nội dung nghe nhìn. |
modalInputs |
boolean | Nếu true hiển thị trình chỉnh sửa phương thức cho các trường nhập văn bản và các lớp con của chúng khi ở trên thiết bị di động, đồng thời hiển thị trình chỉnh sửa nội tuyến trên máy tính. Nếu false hiển thị một trình chỉnh sửa nội tuyến trên cả máy tính và thiết bị di động. Mặc định là true. |
move |
đối tượng | Định cấu hình hành vi về 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 true, các thao tác trên danh sách và chuỗi sẽ lập chỉ mục từ 1, nếu false, chỉ mục từ 0. Giá trị mặc định là true. |
plugins |
đối tượng | Một đối tượng ánh xạ các tên kiểu đăng ký với các lớp thay thế hoặc tên đã đăng ký của các lớp thay thế. Xem phần Chèn lớp thay thế. |
readOnly |
boolean | Nếu true, hãy ngăn người dùng chỉnh sửa. Ẩn hộp công cụ và thùng rác. Giá trị mặc định là false. Xem thêm setIsReadOnly và isReadOnly. |
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 tương tự như Scratch). Để biết thông tin về trình kết xuất tuỳ chỉnh, hãy xem bài viết Tạo trình kết xuất tuỳ chỉnh. |
rtl |
boolean | Nếu 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 mà thuộc tính horizontal xác định xem có bật chế độ cuộn ngang hay không và thuộc tính vertical xác định xem có bật chế độ cuộn dọc hay không. Nếu một giá trị boolean được truyền thì giá trị đó 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 làm giá trị đó. Mặc định là true nếu hộp công cụ có các danh mục. |
sounds |
boolean | Nếu false, hãy tắt âm thanh. Giá trị mặc định là true. |
theme |
Giao diện | Giá trị 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 dạng cây của các danh mục và khối mà người dùng có thể sử 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 nằm ngang) hoặc bên trái (nếu nằm dọc và LTR) hoặc bên phải (nếu nằm 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ó danh mục, false nếu không. |
zoom |
đối tượng | Định cấu hình hành vi thu phóng. Xem phần Thu phóng. |