blockly > 变量

Variables 命名空间

函数

功能 说明
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”等。跳过“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 查找,而不是按名称和类型查找。
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