Инъекция
Вы можете внедрить рабочую область Blockly с помощью вызова Blockly.inject(location, options) . Первый аргумент сообщает Blockly, куда внедрить рабочую область в DOM. Второй аргумент — это словарь пар имя-значение, который используется для настройки. Код внедрения анализирует словарь параметров в экземпляр Blockly.Options .
Прямое создание
Вы также можете создать рабочую область напрямую, вызвав Blockly.WorkspaceSvg(new Blockly.Options(options)) . Обратите внимание, что вам нужно вызвать new Blockly.Options(options) , передав словарь параметров — конструктор рабочей области ожидает экземпляр Blockly.Options , а не пустой словарь параметров.
Словарь опций
Поддерживаются следующие параметры. Обратите внимание, что некоторые из этих параметров меняют свое значение по умолчанию в зависимости от того, имеет ли предоставленный набор инструментов категории или нет.
| Имя | Тип | Описание |
|---|---|---|
collapse | логическое значение | Позволяет сворачивать и разворачивать блоки. По умолчанию имеет значение true , если панель инструментов имеет категории, в противном случае — false . |
comments | логическое значение | Позволяет блокам оставлять комментарии. По умолчанию имеет значение true , если панель инструментов имеет категории, в противном случае — false . |
css | логическое значение | Если false, не добавляйте CSS (при условии, что CSS становится обязанностью документа). По умолчанию true . |
disable | логическое значение | Позволяет отключать блоки. По умолчанию имеет значение true , если панель инструментов имеет категории, в противном случае — false . |
grid | объект | Настраивает сетку, к которой могут привязываться блоки. См. Сетка . |
horizontalLayout | логическое значение | Если true панель инструментов горизонтальна, если false панель инструментов вертикальна. По умолчанию установлено значение false . |
maxBlocks | число | Максимальное количество блоков, которые можно создать. Полезно для студенческих упражнений. По умолчанию Infinity . |
maxInstances | объект | Сопоставьте типы блоков с максимальным количеством блоков этого типа, которые можно создать. Необъявленные типы по умолчанию имеют значение Infinity . Пример: maxInstances: {'controls_if': 3, 'math_number': 42} |
media | нить | Путь от страницы (или фрейма) к медиа-каталогу Blockly. По умолчанию "https://blockly-demo.appspot.com/static/media/" . |
move | объект | Настраивает поведение пользователей при перемещении по рабочей области. См. Переместить . |
oneBasedIndex | логическое значение | Если true операции со списками и строками должны индексироваться с 1 , если false — с 0 . По умолчанию true . |
readOnly | логическое значение | Если true , запретить пользователю редактировать. Подавляет набор инструментов и мусорную корзину. По умолчанию установлено значение false . |
renderer | нить | Определяет средство рендеринга, используемое Blockly. Предварительно упакованные средства визуализации включают «geras» (по умолчанию), «thrasos» и «zelos» (средство визуализации, похожее на царапины). |
rtl | логическое значение | Если true , зеркально отобразить редактор (для языков арабского или иврита). См. демонстрацию RTL . По умолчанию установлено значение false . |
scrollbars | объект или логическое значение | Устанавливает, имеет ли рабочее пространство вертикальные или горизонтальные полосы прокрутки. Принимает объект, в котором свойство horizontal определяет, включена ли горизонтальная прокрутка, а свойство vertical определяет, включена ли вертикальная прокрутка. Если передается логическое значение, это эквивалентно передаче объекта с horizontal и vertical свойствами, установленными в качестве этого значения. По умолчанию — true если панель инструментов имеет категории. |
sounds | логическое значение | Если false , звуки отключаются. По умолчанию true . |
theme | Тема | По умолчанию используется классическая тема, если тема не указана. См . Темы . |
toolbox | строка, XML или JSON | Древовидная структура категорий и блоков, доступных пользователю. См. определение набора инструментов для получения дополнительной информации. |
toolboxPosition | нить | Если панель инструментов "start" находится сверху (если горизонтально) или слева (если вертикально и LTR) или справа (если вертикально и RTL). Если "end" набор инструментов находится на противоположной стороне. По умолчанию "start" . |
trashcan | логическое значение | Отображает или скрывает корзину. По умолчанию имеет значение true , если панель инструментов имеет категории, в противном случае — false . |
maxTrashcanContents | число | Максимальное количество удаленных элементов, которые появятся во всплывающем меню корзины. «0» отключает эту функцию. По умолчанию «32». |
plugins | объект | Сопоставление типа плагина с именем зарегистрированного плагина или класса плагина. См. внедрение подклассов . |
zoom | объект | Настраивает поведение масштабирования. См. Масштаб . |