Blockly 套件
類別
類別 | 說明 |
---|---|
ASTNode | AST 節點的類別。建議您使用其中一種 createNode 方法,而不要直接建立節點。 |
BasicCursor | 基本遊標的類別。如此一來,使用者只要按下下一個或上一個按鈕,就能取得 AST 中的所有節點。 |
封鎖 | 一個區塊的類別。通常不會直接呼叫 workspace.newBlock()。 |
BlockSvg | 區塊的 SVG 表示法類別。通常不會直接呼叫 workspace.newBlock()。 |
CodeGenerator | 用於將區塊翻譯成語言的程式碼產生器類別。 |
CollapsibleToolboxCategory | 工具箱中可收合的類別類別。 |
ComponentManager | 管理員,讓您管理透過工作區註冊的所有項目。 |
連線 | 區塊之間的連線類別。 |
ConnectionChecker | 連線類型檢查邏輯的類別。 |
ConnectionDB | 連線資料庫。系統會按照垂直元件依序儲存連線。如此一來,您便可以使用二進制搜尋快速查詢某區域內的連線。 |
ContextMenuRegistry | 內容選單項目的登錄檔類別。這是單例模式。請勿建立新的執行個體,只能透過 ContextMenuRegistry.registry 存取這個類別。 |
遊標 | 遊標的類別。遊標可控管使用者區塊 AST 的瀏覽方式。 |
DeleteArea | 元件的抽象類別,用於刪除疊加的區塊或對話框。 |
DragTarget | 將方塊或對話框拖曳到包含自訂行為的元件類別 |
FieldCheckbox | 核取方塊欄位的類別。 |
FieldDropdown | 可編輯的下拉式選單欄位類別。 |
FieldImage | 區塊上的圖片類別。 |
FieldLabel | 無法編輯、不可序列化的文字欄位的類別。 |
FieldLabelSerializable | 無法編輯、可序列化的文字欄位的類別。 |
FieldNumber | 可編輯的數字欄位類別。 |
FieldTextInput | 可編輯的文字欄位類別。 |
FieldVariable | 變數下拉式選單欄位的類別。 |
FlyoutButton | 跳出訊息中的按鈕或標籤類別。 |
FlyoutMetricsManager | 計算飛輪的工作區指標。指標主要用於在展開時調整捲軸大小。 |
手勢 | 一個手勢的類別。 |
格線 | 工作區格狀檢視畫面的類別。 |
HorizontalFlyout | 升空艙 |
輸入功率 | 包含選填欄位的輸入類別。 |
InsertionMarkerManager | 類別可在拖曳期間控制連線的更新。主要必須負責找出距離最近的有效連線,並在拖曳過程中視需要醒目顯示或取消醒目顯示連線。 |
InsertionMarkerPreviewer | |
Marker | 標記的類別。這會用於鍵盤導覽功能,可將位置儲存在 Blockly AST 中。 |
MarkerManager | 用來管理工作區中多個標記和遊標的類別。 |
選單 | 基本選單類別。 |
MenuItem | 代表選單中項目的類別。 |
MetricsManager | 所有工作區指標計算的管理員。 |
名稱 | 實體名稱資料庫 (變數、程序等) 的類別。 |
選項 | 在未指定行為的情況下,使用合理的預設值剖析使用者指定選項。 |
RenderedConnection | 此類別用於顯示在螢幕上這些區塊之間的連線。 |
捲軸 | 純 SVG 捲軸的類別。這項技術提供的捲軸保證可正常運作,但外觀或運作方式可能與系統捲軸不同。 |
ScrollbarPair | 一組捲軸的類別。橫向和直向。 |
ShortcutRegistry | 鍵盤快速鍵的登錄類別。這是單例模式。請勿建立新的執行個體,只能透過 ShortcutRegistry. Registry 存取這個類別。 |
TabNavigateCursor | 用於在可瀏覽分頁之間導覽的遊標。 |
主題 | 主題類別。 |
ThemeManager | 用於儲存及更新工作區主題和 UI 元件的類別。 |
工具箱 | Toolbox 的類別。建立工具箱的 DOM。 |
ToolboxCategory | 工具箱中類別的類別。 |
ToolboxItem | 工具箱中項目的類別。 |
ToolboxSeparator | 工具箱分隔符的類別。工具箱上顯示的細線視覺線條。無法互動這個項目。 |
垃圾桶 | 那種垃圾罐? |
UnattachedFieldError | 代表該欄位在嘗試存取其區塊或關於其區塊的資訊,但實際上尚未附加至該區塊的錯誤。 |
VariableMap | 變數對應類別。這包含以變數類型做為索引鍵的字典資料結構,以及將變數清單做為值的清單。變數清單是鍵表示的類型。 |
VariableModel | 變數模型的類別。保留變數資訊,包括名稱、ID 和類型。 |
VerticalFlyout | 升空艙 |
Workspace | 工作區類別。此為包含區塊的資料結構。沒有 UI,可以在無頭模式下建立。 |
WorkspaceAudio | 用於載入、儲存和播放工作區音訊的類別。 |
WorkspaceDragger | 工作區拖曳工具類別。系統會以滑鼠或觸控的方式拖曳工作區, |
WorkspaceSvg | 工作區類別。這個畫面上的區域可讓您選用垃圾桶、捲軸、對話框和拖曳項目。 |
ZoomControls | 縮放控制項的類別。 |
抽象類別
抽象類別 | 說明 |
---|---|
欄位 | 可編輯欄位的抽象類別。 |
延伸 | 升空艙 |
列舉
Enumeration | 說明 |
---|---|
ConnectionType | 連線或輸入類型的列舉, |
函式
函式 | 說明 |
---|---|
hasBubble(obj) | 檢查指定物件是否為 IHasBubble 的型別防護。 |
hideChaff(opt_onlyClosePopups) | 關閉工具提示、內容選單、下拉式選單選項等。 |
inject(container, opt_options) | 將 Blockly 編輯器插入指定的容器元素 (通常是 div)。 |
isCopyable(obj) | |
isDeletable(obj) | 傳回指定物件是否為 IDeletable。 |
isDraggable(obj) | 傳回指定物件是否為 IDraggable。 |
isIcon(obj) | 類型 Guard 檢查指定物件是否為圖示。 |
isPaster(obj) | |
isSelectable(obj) | 檢查指定物件是否為 ISelectable。 |
isSerializable(obj) | 檢查指定物件是否為 ISerializable 的型別防護。 |
isVariableBackedParameterModel(param) | 傳回指定物件是否為變數持有者。 |
setLocale(locale) | 將語言代碼 (也就是本地化的訊息/block-text 等) 設為指定語言代碼。 從指令碼標記載入時,這並不實用/需要,因為訊息會自動歸入 Blockly.Msg 物件。但我們會同時在指令碼標記和非指令碼標記結構定義中提供這項資訊,讓 tscompile 能正確建立類型定義檔。 |
介面
命名空間
變數
變數 | 說明 |
---|---|
封鎖條件 | 區塊類型名稱的對應,用於區塊原型物件。 |
COLLAPSE_CHARS | |
COLLAPSED_FIELD_NAME | |
COLLAPSED_INPUT_NAME | |
設定 | 這個物件會保留所有 Blockly 上的值,我們期望開發人員能夠變更。 |
defineBlocksWithJsonArray | 定義 JSON 區塊定義陣列的區塊,可能由封鎖開發人員工具產生。 |
DELETE_VARIABLE_ID | |
DropDownDiv | |
getMainWorkspace | 傳回主要工作區。傳回上次使用的主要工作區 (依據焦點)。盡量不要使用此函式,尤其是網頁上有多個「封鎖」的執行個體時。 |
getSelected | 傳回目前所選的可複製物件。 |
INPUT_VALUE | |
JavaScript | |
相片 | 本地化訊息的字典。 |
NEXT_STATEMENT | |
OPPOSITE_TYPE | |
OUTPUT_VALUE | |
PREVIOUS_STATEMENT | |
PROCEDURE_CATEGORY_NAME | 用於 Toolbox XML 中類別「custom」屬性的字串。此字串表示該類別應以程序區塊動態填入。 |
RENAME_VARIABLE_ID | |
setParentContainer | 設定父項容器。這是在第一次呼叫 Blockly.inject 時,WidgetDiv、DropDownDiv 和工具提示的容器元素。如果在第一個 Blockly.inject 之後呼叫,這個方法就屬於 NOP。 |
svgResize | 調整 SVG 圖片大小,使其完全填滿容器。在檢視畫面實際變更大小時呼叫此方法 (例如在視窗大小變更/裝置螢幕方向變更時)。當內容有所變動 (例如新增或移除區塊時),請參閱 workspace.resizeContents 調整工作區的大小。記錄 SVG 圖片的高度/寬度。 |
TOOLBOX_AT_BOTTOM | |
TOOLBOX_AT_LEFT | |
TOOLBOX_AT_RIGHT | |
TOOLBOX_AT_TOP | |
VARIABLE_CATEGORY_NAME | 用於 Toolbox XML 中類別「custom」屬性的字串。此字串表示類別應動態填入變數區塊。 |
VARIABLE_DYNAMIC_CATEGORY_NAME | 用於 Toolbox XML 中類別「custom」屬性的字串。此字串表示類別應動態填入變數區塊。 |
版本 | 區塊核心版本。建構指令碼 (npm 執行建構版本) 會將此常數覆寫為 package.json 中的版本值。這透過 buildCompress gulp 工作中的 Closure Compiler 完成。針對本機建構,您可以將 --def='Blockly.VERSION=X.Y.Z' 傳遞至編譯器,藉此覆寫此常數。 |
型別別名
類型別名 | 說明 |
---|---|
FieldCheckboxValidator | 呼叫的函式,可在設定欄位值之前驗證欄位值的變更。 |
FieldDropdownConfig | 下拉式選單欄位的設定選項。 |
FieldDropdownValidator | 呼叫的函式,可在設定欄位值之前驗證欄位值的變更。 |
FieldNumberValidator | 呼叫的函式,可在設定欄位值之前驗證欄位值的變更。 |
FieldTextInputConfig | 文字輸入欄位的設定選項。 |
FieldTextInputValidator | 呼叫的函式,可在設定欄位值之前驗證欄位值的變更。 |
FieldValidator | 呼叫的函式,可在設定欄位值之前驗證欄位值的變更。 |
FieldVariableValidator | 呼叫的函式,可在設定欄位值之前驗證欄位值的變更。 |
ICopyData | |
MenuGenerator | 選單選項的陣列,或是為 FieldDropdown 或其子系產生選單選項陣列的函式。 |
MenuGeneratorFunction | 這個函式會針對 FieldDropdown 或其子系產生選單選項陣列。 |
MenuOption | 下拉式選單中的個別選項。第一個元素是使用者可理解的值 (文字或圖片),第二個元素則是語言中立值。 |