建立工作區

您可以建立工作區並在單一呼叫中將其插入 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 object 將區塊類型對應至可建立的該類型區塊數量上限。未宣告的型別預設為 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 object 設定使用者在工作區中移動的方式。請參閱「移動」一節。
oneBasedIndex 布林值 如果 true 清單和字串作業應從 1 建立索引,請從 0 建立 false 索引。預設值為 true
plugins object 物件對應登錄檔會將型別名稱對應至替代類別,或是替代類別的已註冊名稱。請參閱「 Inject your replacement class」。
readOnly 布林值 如果為 true,請禁止使用者編輯。隱藏工具箱和垃圾桶。預設值為 false。另請參閱 setIsReadOnlyisReadOnly
renderer 字串 決定 Blockly 使用的算繪器。預先封裝的算繪器包括 'geras' (預設)、'thrasos''zelos' (類似 Scratch 的算繪器)。如要瞭解自訂算繪器,請參閱「建立自訂算繪器」。
rtl 布林值 如果是 true,請鏡像顯示編輯器 (適用於阿拉伯文或希伯來文地區設定)。 請參閱 RTL 示範。預設值為 false
scrollbars 物件或布林值 設定工作區是否要顯示垂直或水平捲軸。這個函式會採用物件,其中 horizontal 屬性會決定是否啟用水平捲動,而 vertical 屬性則會決定是否啟用垂直捲動。如果傳遞布林值,則相當於傳遞物件,且 horizontalvertical 屬性都設為該值。如果工具箱有類別,則預設值為 true
sounds 布林值 如果為 false,則會停用音效。預設為 true
theme 主題 如未提供任何主題,系統會預設為傳統主題。 請參閱「主題」一文。
toolbox 字串、XML 或 JSON 使用者可用的類別和區塊樹狀結構。詳情請參閱定義工具箱
toolboxPosition 字串 如果 'start' 工具箱位於頂端 (水平) 或左側 (垂直和 LTR) 或右側 (垂直和 RTL)。如果 'end' 工具箱位於另一側,預設值為 'start'
trashcan 布林值 顯示或隱藏垃圾桶。如果工具箱有類別,預設值為 true,否則為 false
zoom 物件 設定縮放行為。詳情請參閱「Zoom」。