blockly > 變數

變數命名空間

函式

函式 說明
allDeveloperVariables(workspace) 找出工作區中區塊使用的所有開發人員變數。開發人員變數絕不會向使用者顯示,但在產生的程式碼中會宣告為全域變數。如要宣告開發人員變數,請定義區塊的 getDeveloperVariables 函式,然後傳回變數名稱清單。供產生器使用。
allUsedVarModels(ws) 找出所有在工作區中使用的使用者建立變數。供產生器使用。如要取得工作區中所有變數的清單 (包括未使用的變數),請呼叫 Workspace.getAllVariables。
createVariableButtonHandler(workspace, opt_callback, opt_type)

處理預設變數工具箱類別中的「建立變數」按鈕。系統會提示使用者輸入變數名稱,包括如果工作區變數中已有名稱相同的名稱,系統就會重新提示使用者。

自訂按鈕處理常式可以委派給這個函式,允許變數類型並在建立後處理。更複雜的自訂 (例如針對變數類型提示) 不在這個函式的涵蓋範圍內。

flyoutCategory(workspace) 建構模組類別所需的元素 (區塊和按鈕)。
flyoutCategoryBlocks(workspace) 建構飛行要求中變數類別所需的方塊。
generateUniqueName(workspace) 傳回尚未使用的新變數名稱。這會嘗試產生開頭為「i」到「z」範圍內的單一字母變數名稱。如果沒有唯一名稱,則會嘗試「i」到「z」、「a」到「h」,接著以「i2」到「z2」等字元。
generateUniqueNameFromOptions(startChar, usedNames) 傳回在 useNames 陣列中沒有的專屬名稱。這會嘗試產生 a - z (略過 l) 範圍內的單一字母名稱。開頭為傳遞至 startChar 的字元。
generateVariableFieldDom(variableModel) 產生代表變數欄位的 DOM 物件。
getOrCreateVariablePackage(workspace, id, opt_name, opt_type) 以輔助函式查詢或建立指定工作區的變數。如果沒有變數,請建立並傳回該變數。
getVariable(workspace, id, opt_name, opt_type) 查詢指定工作區的變數。請一律先查看主要工作區,再查看飛出工作區。一律偏好按 ID 查詢,按名稱 + 類型查詢。
nameUsedWithAnyType(name, workspace) 檢查是否存在具有任何類型的指定名稱的變數。
promptName(promptText, defaultText, callback) 提示使用者輸入新的變數名稱。
renameVariable(workspace, variable, opt_callback) 開啟提示,讓使用者為變數輸入新名稱。如果新名稱有效,系統就會觸發重新命名作業。或是在出現衝突時重新提示。

Variables

變數 說明
CATEGORY_NAME 在工具箱 XML 中,用於類別「自訂」屬性的字串。這個字串表示類別應以動態方式填入變數區塊。另請參閱 Blockly.Procedures.CATEGORY_NAME 和 Blockly.VariablesDynamic.CATEGORY_NAME。
TEST_ONLY
VAR_LETTER_OPTIONS