blockly > Variables

Espacio de nombres de las variables

Funciones

Función Descripción
allDeveloperVariables(workspace)

Busca todas las variables de desarrollador que usan los bloques en el espacio de trabajo.

Las variables del desarrollador nunca se muestran al usuario, sino que se declaran como variables globales en el código generado. Para declarar variables de desarrollador, define la función getDeveloperVariables en tu bloque y muestra una lista de nombres de variables. Para uso de generadores.

allUsedVarModels(ws)

Encuentra todas las variables creadas por el usuario que se usan en el espacio de trabajo. Para uso de generadores.

Para obtener una lista de todas las variables de un lugar de trabajo, incluidas las que no se usan, llama a getAllVariables.

createVariableButtonHandler(workspace, opt_callback, opt_type)

Controla el botón "Crear variable" en la categoría de la caja de herramientas de variables predeterminadas. Se le pedirá al usuario un nombre de variable, incluidas las indicaciones adicionales si ya se está usando un nombre entre las variables del espacio de trabajo.

Los controladores de botones personalizados pueden delegar a esta función, lo que permite tipos de variables y procesamiento posterior a la creación. La personalización más compleja (p.ej., solicitar el tipo de variable) está fuera del alcance de esta función.

deleteVariable(workspace, variable, triggeringBlock) Borra una variable y todos sus usos del espacio de trabajo determinado. Es posible que se le solicite confirmación al usuario.
flyoutCategory(workspace, useXml)
flyoutCategory(workspace, useXml)
flyoutCategoryBlocks(workspace) Construye los bloques que requiere el menú flotante para la categoría de variable.
generateUniqueName(workspace) Muestra un nombre de variable nuevo que aún no se usa. Para empezar, se intentará generar nombres de variables de una sola letra en el rango de "i" a "z". Si no se encuentra un nombre único, se intentará con "i" a "z", "a" a "h", luego "i2" a "z2", etcétera. Se omite "l".
generateUniqueNameFromOptions(startChar, usedNames) Devuelve un nombre único que no está presente en el array usedNames. Se intentará generar nombres de una sola letra en el rango a - z (se omite la l). Comenzará con el carácter que se pasó a startChar.
generateVariableFieldDom(variableModel) Genera objetos DOM que representen un campo variable.
getOrCreateVariablePackage(workspace, id, opt_name, opt_type) Es una función auxiliar para buscar o crear una variable en el espacio de trabajo determinado. Si no existe ninguna variable, la crea y la muestra.
getVariable(workspace, id, opt_name, opt_type) Busca una variable en el espacio de trabajo determinado. Siempre busca en el espacio de trabajo principal antes de buscar en el espacio de trabajo flotante. Siempre prefiere la búsqueda por ID a la búsqueda por nombre y tipo.
getVariableUsesById(workspace, id) Encuentra todos los usos de una variable nombrada.
nameUsedWithAnyType(name, workspace) Verifica si existe una variable con el nombre determinado de cualquier tipo.
promptName(promptText, defaultText, callback) Pídele al usuario que ingrese un nombre de variable nuevo.
renameVariable(workspace, variable, opt_callback) Abre un mensaje que le permite al usuario ingresar un nombre nuevo para una variable. Activa un cambio de nombre si el nombre nuevo es válido. O vuelve a solicitarlo si hay una colisión.

Variables

Variable Descripción
CATEGORY_NAME Es una cadena para usar en el atributo "custom" de una categoría en el archivo XML de Toolbox. Esta cadena indica que la categoría se debe propagar de forma dinámica con bloques de variables. Consulta también Blockly.Procedures.CATEGORY_NAME y Blockly.VariablesDynamic.CATEGORY_NAME.
TEST_ONLY
VAR_LETTER_OPTIONS