變數命名空間
函式
函式 | 說明 |
---|---|
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 |