避孕针
您可以通过调用 Blockly.inject(location, options) 来注入 Blockly 工作区。第一个参数用于告知 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。 |
media
|
字符串 | 从网页（或框架）到 Blockly 媒体目录的路径。
默认值为 "https://blockly-demo.appspot.com/static/media/"。 |
move
|
对象 | 配置用户在工作区中移动的方式。请参阅移动。 |
oneBasedIndex
|
布尔值 | 如果为 true，则列表和字符串操作应从 1 开始索引；如果 false 索引从 0 开始。默认值为 true。 |
readOnly
|
布尔值 | 如果为 true，则禁止用户修改。抑制工具箱和垃圾桶。默认设置为 false。 |
renderer
|
字符串 | 确定块所使用的渲染程序。预封装的渲染程序包括“geras”（默认）、“thrasos”和“zelos”（一种类似于暂存的渲染程序）。 |
rtl
|
布尔值 | 如果为 true，则镜像编辑器（针对阿拉伯语或希伯来语语言区域）。
请参阅 RTL 演示。默认值为 false。 |
scrollbars
|
对象或布尔值 | 设置工作区是具有垂直滚动条还是水平滚动条。获取一个对象，其中 horizontal 属性用于确定是否已启用水平滚动，vertical 属性用于确定是否已启用垂直滚动。如果传递布尔值，则等同于传递同时将 horizontal 和 vertical 属性都设为该值的对象。如果工具箱包含类别，则默认为 true。 |
sounds |
boolean | 如果为 false，则停用声音。默认设置为 true。 |
theme
|
主题 | 如果未提供任何主题，则默认为经典主题。 请参阅主题。 |
toolbox
|
字符串、XML 或 JSON | 用户可用的类别和块的树形结构。如需了解详情，请参阅定义工具箱。 |
toolboxPosition
|
字符串 | 表示 "start" 工具箱位于顶部（如果是水平方向），或者位于左侧（如果是垂直方向且 LTR）或右侧（如果是垂直方向且 RTL）。如果 "end" 工具箱位于另一侧。默认值为 "start"。 |
trashcan
|
布尔值 | 显示或隐藏垃圾桶。如果工具箱具有类别，则默认为 true，否则默认为 false。 |
maxTrashcanContents
|
数值 | 将显示在垃圾桶浮出控件中的已删除项的数量上限。“0”表示停用此功能。默认值为“32”。 |
plugins
|
对象 | 插件类型到已注册插件或插件类的名称的映射。请参阅注入子类。 |
zoom |
对象 | 配置缩放行为。请参阅缩放。 |