您可以建立工作區並在單一呼叫中將其插入 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 。另請參閱 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」。 |