變數命名空間
函式
| 函式 | 說明 |
|---|---|
| allDeveloperVariables(workspace) | 找出工作區中區塊使用的所有開發人員變數。 開發人員變數不會向使用者顯示，但會在產生的程式碼中宣告為全域變數。如要宣告開發人員變數，請在區塊中定義 getDeveloperVariables 函式，並傳回變數名稱清單。供產生器使用。 |
| allUsedVarModels(ws) | 找出工作區中所有使用者建立的變數。供產生器使用。 如要取得工作區中的所有變數清單 (包括未使用的變數)，請呼叫 getAllVariables。 |
| createVariableButtonHandler(workspace, opt_callback, opt_type) | 處理預設變數工具箱類別中的「建立變數」按鈕。系統會提示使用者輸入變數名稱，如果工作區的變數中已有名稱，系統會重新提示。 自訂按鈕處理常式可委派至這個函式，允許變數類型和建立後的處理作業。更複雜的自訂項目 (例如提示變數類型) 不在這個函式的範圍內。 |
| deleteVariable(workspace, variable, triggeringBlock) | 從指定工作區中刪除變數及其所有用途。可能會提示使用者進行確認。 |
| flyoutCategory(workspace, useXml) | |
| flyoutCategory(workspace, useXml) | |
| flyoutCategoryBlocks(workspace) | 為變數類別建構彈出式選單所需的區塊。 |
| generateUniqueName(workspace) | 傳回尚未使用的新變數名稱。這會嘗試產生開頭為「i」到「z」的單字母變數名稱。如果找不到專屬名稱，系統會嘗試使用「i」到「z」、「a」到「h」，然後「i2」到「z2」等，並略過「l」。 |
| generateUniqueNameFromOptions(startChar, usedNames) | 傳回不存在於 usedNames 陣列中的不重複名稱。這會嘗試產生 a 到 z 範圍內的單字母名稱 (略過 l)。開頭字元會是傳遞至 startChar 的字元。 |
| generateVariableFieldDom(variableModel) | 產生代表變數欄位的 DOM 物件。 |
| getOrCreateVariablePackage(workspace, id, opt_name, opt_type) | 輔助函式，可在指定工作區中查詢或建立變數。如果不存在任何變數，則建立並傳回變數。 |
| getVariable(workspace, id, opt_name, opt_type) | 在指定工作區中查詢變數。請務必先查看主要工作區，再查看彈出式工作區。請務必使用 ID 查詢，而非名稱 + 類型查詢。 |
| getVariableUsesById(workspace, id) | 找出已命名變數的所有用途。 |
| nameUsedWithAnyType(name, workspace) | 檢查是否有任何類型的變數具有指定名稱。 |
| promptName(promptText, defaultText, callback) | 提示使用者輸入新的變數名稱。 |
| renameVariable(workspace, variable, opt_callback) | 開啟提示，讓使用者輸入變數的新名稱。如果新名稱有效，就會觸發重新命名作業。或在發生衝突時重新提示。 |
變數
| 變數 | 說明 |
|---|---|
| CATEGORY_NAME | 在工具箱 XML 中，用於類別「custom」屬性的字串。這個字串表示應動態填入變數區塊的類別。另請參閱 Blockly.Procedures.CATEGORY_NAME 和 Blockly.VariablesDynamic.CATEGORY_NAME。 |
| TEST_ONLY | |
| VAR_LETTER_OPTIONS |