blockly > Bloque

Clase de bloque

Clase de un solo bloque. Por lo general, no se lo llama directamente, por lo que se prefiere workspace.newBlock().

Signature:

export declare class Block 

Constructores

Constructor	Modificadores	Descripción
(constructor)(workspace, prototypeName, opt_id)		Construye una instancia nueva de la clase Block.

Propiedades

Propiedad	Modificadores	Tipo	Descripción
childBlocks_	protected	this[]
collapsed_	protected	booleano
COLLAPSED_FIELD_NAME	static readonly	string	Es el ID sin idioma asignado al campo colapsado.
COLLAPSED_INPUT_NAME	static readonly	string	Es el ID independiente del idioma que se le asignó a la entrada contraída.
colour_	protected	string	Es el color del bloque en formato "#RRGGBB".
¿compose?		(rootBlock: Block) => void	(Opcional) Es un método opcional que reconfigura el bloque según el contenido del diálogo del modificador.
contextMenu		booleano
datos		string | null	Datos de texto opcionales que realizan un recorrido de ida y vuelta entre bloques y XML. Sin efecto. Es posible que terceros lo usen para metainformación.
decomponer?		(workspace: Workspace) => Bloquear	(Opcional) Es una función opcional que propaga el menú flotante del modificador con bloques que representan la configuración de este bloque.
destruir?		() => void	(Opcional) Es un método opcional al que se llama durante la eliminación.
disposición	protected	booleano	¿El bloque actual se encuentra en proceso de eliminación?
domToMutation?		(p1: Element) => void	(Opcional) Es un método de deserialización opcional para definir cómo deserializar el estado de mutación desde XML. Esto debe combinarse con la definición de mutationToDom.
¿getDeveloperVariables?		() => string[]	(Opcional) Es un método opcional para declarar variables de desarrollador que usarán los generadores. Las variables del desarrollador nunca se muestran al usuario, sino que se declaran como variables globales en el código generado.
sombrero?		string	(Opcional) Es el nombre del tipo de sombrero.
helpUrl		string | (() => string) | null	Es una cadena para la ayuda del bloque o una función que muestra una URL. Es nulo si no se necesita ayuda.
íconos		IIcon[]
id		string
¿init?		() => void	(Opcional) Es un método opcional al que se llama durante la inicialización.
inputList		Entrada[]
inputsInline?		booleano	(Opcional)
inputsInlineDefault?		booleano	(Opcional)
isInFlyout		booleano
isInMutator		booleano
isInsertionMarker_	protected	booleano	Es verdadero si este bloque es un marcador de inserción.
¿loadExtraState?		(p1: any) => void	(Opcional) Es un método de serialización opcional para definir cómo deserializar el estado adicional del bloque (p. ej., el estado de mutación) desde algo compatible con JSON. Esto debe combinarse con la definición de saveExtraState.
¿mutationToDom?		(...p1: any[]) => Element	(Opcional) Es un método de serialización opcional para definir cómo serializar el estado de mutación en XML. Esto debe combinarse con la definición de domToMutation.
nextConnection		Connection | null
onchange?		((p1: Abstract) => void) | null	(Opcional) Es un método de devolución de llamada opcional que se usa cada vez que cambia el lugar de trabajo superior del bloque. Por lo general, solo se llama desde el constructor, la función de inicializador de tipo de bloque o una función de inicializador de extensión.
outputConnection		Connection | null
outputShape_	protected	number | null
parentBlock_	protected	this | null
previousConnection		Connection | null
renderizado	readonly	booleano	¿Este bloque es un BlockSVG?
RTL		booleano
saveExtraState?		(doFullSerialization?: boolean) => any	(Opcional) Es un método de serialización opcional para definir cómo serializar el estado adicional del bloque (p. ej., el estado de mutación) a algo compatible con JSON. Esto debe combinarse con la definición de loadExtraState.
styleName_	protected	string	Es el nombre del estilo de bloque.
suppressPrefixSuffix		boolean | null	Es una propiedad opcional para suprimir la adición de STATEMENT_PREFIX y STATEMENT_SUFFIX al código generado.
cuadro de información		Tooltip.TipInfo
type		string
workspace		Workspace

Métodos

Método	Modificadores	Descripción
addIcon(icon)		Agrega el ícono determinado al bloque.
allInputsFilled(opt_shadowBlocksAreFilled)		Comprueba de forma recursiva si todas las entradas de instrucciones y valores están completas con bloques. También verifica todos los siguientes bloques de instrucciones en esta pila.
appendDummyInput(name)		Agrega una fila de entrada simulada.
appendEndRowInput(name)		Agrega una entrada que finaliza la fila.
appendInput(input)		Adjunta la fila de entrada determinada. Permite que se adjunten entradas personalizadas al bloque.
appendStatementInput(name)		Agrega una fila de entrada de sentencia.
appendValueInput(name)		Agrega una fila de entrada de valor.
bumpNeighbours()		Desplaza los bloques desconectados fuera de alineación. Dos bloques que no están conectados no deben alinearse de forma coincidente en la pantalla.
dispose(healStack)		Descarta este bloque.
disposeInternal()	protected	Se deshace de este bloque sin hacer lo que requiere el bloque superior. p.ej., no activa eventos, no desconecta el bloque, etcétera.
doInit_()	protected	Llama a la función init() y controla el disparo de eventos asociados, etcétera.
getChildren(ordered)		Busca todos los bloques que están anidados directamente dentro de este. Incluye entradas de valor y sentencia, así como cualquier sentencia posterior. Excluye cualquier conexión en una pestaña de salida o cualquier sentencia anterior. De manera opcional, los bloques se ordenan por posición, de arriba abajo.
getColour()		Obtén el color de un bloque.
getCommentText()		Muestra el comentario de este bloque (o nulo si no hay comentarios).
getDescendants(ordered)		Busca todos los bloques que están anidados directamente o indirectamente dentro de este. Incluye este bloque en la lista. Incluye entradas de valor y de sentencia, así como cualquier sentencia posterior. Excluye cualquier conexión en una pestaña de salida o cualquier sentencia anterior. De manera opcional, los bloques se ordenan por posición, de arriba abajo.
getDisabledReasons()		Obtén un conjunto de motivos por los que el bloqueo está inhabilitado actualmente, si corresponde. Si el bloqueo está habilitado, este conjunto estará vacío.
getField(name)		Muestra el campo con nombre de un bloque.
getFields()		Muestra un generador que proporciona todos los campos del bloque. Es un generador que se puede usar para iterar los campos del bloque.
getFieldValue(name)		Muestra el valor independiente del idioma del campo determinado.
getHue()		Obtén el valor de tono HSV de un bloque. Es nulo si no se establece el tono.
getIcon(type)
getIcons()
getInheritedDisabled()		Obtén información sobre si el bloqueo está inhabilitado o no debido a los padres. No se considera la propiedad inhabilitada del bloque.
getInput(name)		Recupera el objeto de entrada nombrado.
getInputsInline()		Obtén si las entradas de valor están organizadas horizontal o verticalmente.
getInputTargetBlock(name)		Recupera el bloque adjunto a la entrada con nombre.
getInputWithBlock(block)		Devuelve la entrada que se conecta al bloque especificado.
getNextBlock()		Devuelve el siguiente bloque de sentencia directamente conectado a este bloque.
getOutputShape()		Obtén la forma de salida del bloque.
getParent()		Muestra el bloque superior o nulo si este bloque está en el nivel superior. El bloque superior es el bloque conectado a la conexión anterior (para un bloque de sentencia) o el bloque conectado a la conexión de salida (para un bloque de valor).
getPreviousBlock()		Muestra el bloque conectado a la conexión anterior.
getRelativeToSurfaceXY()		Muestra las coordenadas de la esquina superior izquierda de este bloque en relación con el origen de la superficie de dibujo (0,0), en unidades de lugar de trabajo.
getRootBlock()		Muestra el bloque superior en el árbol de este bloque. Se mostrará a sí mismo si este bloque está en el nivel superior.
getStyleName()		Obtén el nombre del estilo de bloque.
getSurroundParent()		Muestra el bloque superior que rodea el bloque actual o nulo si este bloque no tiene un bloque circundante. Un bloque superior puede ser solo la sentencia anterior, mientras que el bloque circundante es una sentencia if, un bucle while, etcétera.
getTooltip()		Muestra el texto de la herramienta de ayuda de este bloque.
getVars()		Devuelve todas las variables a las que hace referencia este bloque.
hasDisabledReason(reason)		Obtén si el bloqueo está inhabilitado actualmente por el motivo proporcionado.
hasIcon(type)
initModel()		Llama a initModel en todos los campos del bloque. Se puede llamar más de una vez. Se debe llamar a initModel o initSvg después de crear un bloque y antes de la primera interacción con él. Las interacciones incluyen acciones de la IU (p.ej., hacer clic y arrastrar) y activar eventos (p.ej., crear, borrar y cambiar).
isCollapsed()		Obtén si el bloque está colapsado o no.
isDeletable()		Obtén si este bloque se puede borrar o no.
isDisposed()		Muestra si este bloque se eliminó o se desechó.
isDuplicatable()		Obtén si el bloque se puede duplicar o no. Si la duplicación de este bloque y sus elementos secundarios lo coloca por encima de la capacidad del espacio de trabajo, no se puede duplicar. Si se duplica este bloque y los elementos secundarios colocan cualquier tipo sobre sus maxInstances, este bloque no se puede duplicar.
isEnabled()		Obtén si este bloqueo está habilitado o no. Un bloque se considera habilitado si no hay motivos para inhabilitarlo. Es posible que un bloqueo siga inhabilitado por otros motivos, incluso si el usuario intenta habilitarlo de forma manual, por ejemplo, cuando el bloqueo está en una ubicación no válida.
isInsertionMarker()		Obtén si este bloque es un bloque de marcador de inserción o no.
isOwnDeletable()		Muestra si la propiedad deletable de este bloque es verdadera o falsa.
isOwnEditable()		Muestra si la propia propiedad editable de este bloque es verdadera o falsa.
isShadow()		Obtén si este bloque es un bloque en sombra o no.
jsonInit(json)		Inicializa este bloque con una descripción JSON multiplataforma y compatible con la internacionalización.
mixin(mixinObj, opt_disableCheck)		Agrega pares clave-valor de mixinObj a este objeto de bloque. De forma predeterminada, este método verificará que las claves en mixinObj no reemplacen los valores existentes en el bloque, incluidos los valores del prototipo. Esto proporciona cierta protección contra las incompatibilidades de mixin o extensión con funciones de bloque futuras. Para inhabilitar esta verificación, pasa verdadero como segundo argumento.
moveBy(dx, dy, reason)		Mueve un bloque por un desplazamiento relativo.
moveInputBefore(name, refName)		Mueve una entrada con nombre a otra ubicación en este bloque.
moveNumberedInputBefore(inputIndex, refIndex)		Mueve una entrada numerada a otra ubicación en este bloque.
removeIcon(type)		Quita del bloque el ícono cuyo getType coincida con el tipo iconType determinado.
removeInput(name, opt_quiet)		Quita una entrada de este bloque.
renameVarById(oldId, newId)		Notificación de que se cambiará el nombre de una variable. Si el ID coincide con una de las variables de este bloque, cámbiale el nombre.
setCollapsed(collapsed)		Establece si el bloque está colapsado o no.
setColour(colour)		Cambiar el color de un bloque
setCommentText(text)		Establece el texto del comentario de este bloque.
setDeletable(deletable)		Establece si este bloque se puede borrar o no.
setDisabledReason(disabled, reason)		Agrega o quita un motivo por el que se podría inhabilitar el bloqueo. Si un bloque tiene algún motivo para inhabilitarse, se considerará inhabilitado. Un bloqueo puede inhabilitarse por varios motivos independientes de forma simultánea, por ejemplo, cuando el usuario lo inhabilita de forma manual o cuando el bloqueo no es válido.
setEditable(editable)		Establece si este bloque se puede editar o no.
setFieldValue(newValue, name)		Establece el valor del campo determinado para este bloque.
setHelpUrl(url)		Establece la URL de la página de ayuda de este bloque.
setInputsInline(newBoolean)		Establece si las entradas de valor se organizan horizontal o verticalmente.
setMovable(movable)		Establece si este bloque es movible o no.
setMutator(_mutator)		Asigna un diálogo de mutador a este bloque.
setNextStatement(newBoolean, opt_check)		Establece si otro bloque puede encadenarse en la parte inferior de este bloque.
setOnChange(onchangeFn)		Establece una función de devolución de llamada para usar cada vez que cambie el lugar de trabajo superior del bloque, lo que reemplazará cualquier controlador onchange anterior. Por lo general, solo se llama desde el constructor, la función de inicializador de tipo de bloque o una función de inicializador de extensión.
setOutput(newBoolean, opt_check)		Establece si este bloque muestra un valor.
setOutputShape(outputShape)		Establece la forma de salida del bloque.
setPreviousStatement(newBoolean, opt_check)		Establece si este bloque puede encadenarse en la parte inferior de otro bloque.
setStyle(blockStyleName)		Establece los valores de estilo y color de un bloque.
setTooltip(newTip)		Establece la información sobre herramientas de este bloque.
setWarningText(_text, _opt_id)		Establece el texto de advertencia de este bloque.
toDevString()		Este método muestra una cadena que describe este bloque en términos de desarrollador (nombre de tipo y ID; solo en inglés). Se diseñó para usarse en errores y registros de la consola. Si necesitas una cadena que use el idioma nativo del usuario (incluidos el texto del bloque, los valores de campo y los bloques secundarios), usa toString().
toString(opt_maxLength, opt_emptyToken)		Crea una representación de texto legible por humanos de este bloque y de sus elementos secundarios.
unplug(opt_healStack)		Desconecta este bloque del bloque superior. Si este bloque es una sentencia, vuelve a conectar el bloque de abajo con el de arriba de forma opcional.