变量命名空间
函数
| 函数 | 说明 |
|---|---|
| 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 | 要在 Toolbox XML 中类别的“custom”属性中使用的字符串。此字符串表示应使用可变块动态填充类别。另请参阅 Blockly.Procedures.CATEGORY_NAME 和 Blockly.VariablesDynamic.CATEGORY_NAME。 |
| TEST_ONLY | |
| VAR_LETTER_OPTIONS |