Tạo một không gian làm việc

Bạn có thể tạo một không gian làm việc và chèn không gian làm việc đó vào DOM trong một lệnh gọi hoặc chỉ tạo một không gian làm việc.

Chèn

Bạn có thể tạo một không gian làm việc Blockly và chèn không gian làm việc đó vào DOM 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 đối tượng chứa các tuỳ 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ể trực tiếp tạo không gian làm việc 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 tuỳ 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ể trực tiếp chấp nhận đối tượng tuỳ chọn cấu hình.

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 tuỳ chọn sau. 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 Liệu trình đơn theo bối cảnh của khối có bao gồm một mục để thu gọn hay mở rộng các khối hay không. 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.
comments boolean Liệu trình đơn theo bối cảnh của khối có chứa 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ó 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ẽ trở thành trách nhiệm của tài liệu). Giá trị mặc định là true.
disable boolean Liệu trình đơn theo bối 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ó 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}
maxTrashcanContents số Số lượng mục đã xoá tối đa sẽ xuất hiện trong trình đơn bật lên của 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 đối với 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, cũng như trình chỉnh sửa cùng dòng trên máy tính. Nếu false hiển thị trình chỉnh sửa cùng dòng 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 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.
plugins đối tượng Một đối tượng ánh xạ tên loại sổ đăng ký đến 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 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 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 là false, hãy tắt âm thanh. Giá trị mặc định là true.
theme Giao diện 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.
zoom đối tượng Định cấu hình hành vi thu phóng. Xem phần Thu phóng.