注入
您可以透過呼叫 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。範例：
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」(類似 Scratch 的轉譯器)。 |
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 |
物件 | 設定縮放行為。請參閱「縮放」。 |