建立工作區

您可以建立工作區並在單一呼叫中將其插入 DOM，或只建立工作區。

注射

您可以建立 Blockly 工作區，並呼叫 Blockly.inject(location, options) 將其插入 DOM。第一個引數會告知 Blockly 要在 DOM 中注入工作區的位置。第二個引數是包含設定選項的物件。

詳情請參閱「建立工作區」。

直接建立

您可以呼叫 new Blockly.WorkspaceSvg(new Blockly.Options(options)) 直接建立工作區。撥打這個呼叫時，請務必在呼叫中傳遞設定選項至 new Blockly.Options(options)，因為 WorkspaceSvg 建構函式無法直接接受設定選項物件。

設定選項

設定物件會實作 Blockly.BlocklyOptions ，並提供下列選項。請注意，如果提供的工具箱有類別，其中幾個選項的預設值會隨之變更。

名稱 類型 說明
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}
maxTrashcanContents 數字 垃圾桶彈出式視窗中顯示的已刪除項目數量上限。'0' 停用這項功能。預設為 '32'。
media 字串 從網頁 (或框架) 到 Blockly 媒體目錄的路徑。預設為 'https://blockly-demo.appspot.com/static/media/'。請參閱「媒體資料夾」。
modalInputs 布林值 如果 true 在行動裝置上顯示文字輸入欄位及其子類別的模態編輯器，在電腦上則顯示內嵌編輯器。如果false，請在電腦和行動裝置上顯示內嵌編輯器。預設值為 true。
move 物件 設定使用者在工作區中移動的方式。請參閱「移動」一節。
oneBasedIndex 布林值 如果 true 清單和字串作業應從 1 建立索引，如果 false 應從 0 建立索引，預設值為 true。
plugins 物件 物件對應登錄檔會將型別名稱對應至替代類別，或替代類別的已註冊名稱。請參閱「插入替代類別」。
readOnly 布林值 如果為 true，請禁止使用者編輯。隱藏工具箱和垃圾桶。預設值為 false。另請參閱 setIsReadOnly 和 isReadOnly。
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。
zoom 物件 設定縮放行為。詳情請參閱「Zoom」。