Tùy chọn chèn

Tiêm

Bạn có thể chèn 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à từ điển của các cặp tên-giá trị được 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 thực thể của Blockly.Options.

Sáng 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), chuyển vào từ điển tuỳ chọn – hàm khởi tạo không gian làm việc yêu cầu một thực thể của Blockly.Options, chứ không phải từ điển bare options (tuỳ chọn đơn giản).

Từ điển tùy chọn

Các tuỳ chọn sau được hỗ trợ. Lưu ý rằng một số tuỳ chọn trong số này thay đổi giá trị mặc định dựa trên việc hộp công cụ được cung cấp có các danh mục hay không.

Tên Loại Nội dung mô tả
collapse boolean Cho phép thu gọn hoặc mở rộng khối. Giá trị mặc định là true nếu hộp công cụ có các danh mục, nếu không, giá trị này sẽ là false.
comments boolean Cho phép khối có nhận xét. Giá trị mặc định là true nếu hộp công cụ có các danh mục,nếu không thì false.
css boolean Nếu giá trị là false thì không được chèn CSS (việc 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 tính năng chặn. Giá trị 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ể bám theo. Hãy xem phần Lưới.
horizontalLayout boolean Nếu hộp công cụ true là hộp công cụ theo chiều ngang, nếu hộp công cụ false là hướng dọc. Mặc định là false.
maxBlocks number Số 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 Liên kết từ các loại khối đến số khối tối đa của loại đó có thể được tạo. Các loại không được khai báo được đặt giá trị mặc định là Infinity.
media string Đường dẫn từ trang (hoặc khung) đến thư mục phương tiện Blockly. Giá trị mặc định là "https://blockly-demo.appspot.com/static/media/".
move đối tượng Thiết lập hành vi về cách người dùng có thể di chuyển xung quanh không gian làm việc. Xem phần Di chuyển.
oneBasedIndex boolean Nếu các thao tác chuỗi và danh sách 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. Chặn hộp công cụ và thùng rác. Giá trị mặc định là false.
renderer string Xác định trình kết xuất được sử dụng theo khối. Các trình kết xuất đóng gói sẵn bao gồm "geras" (mặc định), "thrsso" và "zelos" (một trình kết xuất giống như vết xước).
rtl boolean Nếu giá trị là true, hãy phản ánh trình chỉnh sửa (dành cho tiế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 Thiết lập xem không gian làm việc có thanh cuộn dọc hoặc ngang. Lấy một đối tượng mà trong đó thuộc tính horizontal xác định xem có bật tính năng cuộn theo chiều ngang hay không và thuộc tính vertical sẽ xác định xem có bật tính năng cuộn theo chiều dọc hay không. Nếu truyền giá trị boolean thì nó tương đương với việc truyền một đối tượng có cả hai thuộc tính horizontal và vertical được đặt làm giá trị đó. 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 Giao diện mặc định là giao diện cổ điển nếu không cung cấp giao diện nào. Xem phần Giao diện.
toolbox chuỗi, XML hoặc JSON Cấu trúc cây của các danh mục và khối mà người dùng có thể sử dụng. Xem phần xác định hộp công cụ để biết thêm thông tin.
toolboxPosition string Nếu hộp công cụ "start" nằm ở 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 chiều dọc và phải). Nếu hộp công cụ "end" nằm ở đối diện. Mặc định là "start".
trashcan boolean Hiển thị hoặc ẩn thùng rác. Giá trị 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 number Số lượng tối đa các mục đã xoá sẽ xuất hiện trong cửa sổ 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".
plugins đối tượng Ánh xạ 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.