blockly

Paquete blockly

Clases

Clase Descripción
Bloquear Clase de un solo bloque. Por lo general, no se lo llama directamente, por lo que se prefiere workspace.newBlock().
BlockFlyoutInflater Es la clase responsable de crear bloques para los menús flotantes.
BlockNavigationPolicy Es un conjunto de reglas que controlan la navegación del teclado desde un bloque.
BlockSvg Es la clase para la representación SVG de un bloque. Por lo general, no se lo llama directamente, por lo que se prefiere workspace.newBlock().
ButtonFlyoutInflater Es la clase responsable de crear botones para los menús flotantes.
CodeGenerator Es una clase para un generador de código que traduce los bloques a un lenguaje.
CollapsibleToolboxCategory Es la clase de una categoría en una caja de herramientas que se puede contraer.
ComponentManager Es el administrador de todos los elementos registrados en el lugar de trabajo.
Conexión Es una clase para una conexión entre bloques.
ConnectionChecker Clase para la lógica de verificación del tipo de conexión.
ConnectionDB Base de datos de conexiones. Las conexiones se almacenan en orden de su componente vertical. De esta manera, las conexiones en un área se pueden buscar rápidamente con una búsqueda binaria.
ConnectionNavigationPolicy Es un conjunto de reglas que controlan la navegación con el teclado desde una conexión.
ContextMenuRegistry Clase para el registro de elementos del menú contextual. Se supone que es un singleton. No debes crear una instancia nueva y solo debes acceder a esta clase desde ContextMenuRegistry.registry.
DeleteArea Es una clase abstracta para un componente que puede borrar un bloque o una burbuja que se coloca encima de él.
DragTarget Es una clase abstracta para un componente con comportamiento personalizado cuando se arrastra un bloque o una burbuja sobre él o se sueltan encima.
FieldCheckbox Es la clase de un campo de casilla de verificación.
FieldDropdown Es la clase de un campo desplegable editable.
FieldImage Es la clase de una imagen en un bloque.
FieldLabel Es una clase para un campo de texto no editable ni serializable.
FieldLabelSerializable Es una clase para un campo de texto no editable y serializable.
FieldNavigationPolicy Es un conjunto de reglas que controlan la navegación con el teclado desde un campo.
FieldNumber Es la clase de un campo de número editable.
FieldTextInput Es la clase de un campo de texto editable.
FieldVariable Es la clase del campo desplegable de una variable.
FlyoutButton Es la clase de un botón o una etiqueta en el menú flotante.
FlyoutButtonNavigationPolicy Es un conjunto de reglas que controlan la navegación con el teclado desde un botón flotante.
FlyoutItem Representación de un elemento que se muestra en un menú flotante.
FlyoutMetricsManager Calcula las métricas del espacio de trabajo de un menú flotante. Las métricas se usan principalmente para ajustar el tamaño de las barras de desplazamiento del menú flotante.
FlyoutNavigationPolicy Política de navegación genérica que navega entre los elementos del menú flotante.
FlyoutNavigator
FlyoutSeparator Representación de un espacio entre elementos en un menú flotante.
FlyoutSeparatorNavigationPolicy Es un conjunto de reglas que controlan la navegación con el teclado desde un separador flotante. Este es un marcador de posición sin operación, ya que no se puede navegar a los separadores flotantes.
FocusableTreeTraverser Es una utilidad de ayuda para las implementaciones de IFocusableTree que ayuda con los recorridos de árbol comunes.
FocusManager

Un singleton por página que administra el enfoque de Blockly en uno o más IFocusableTrees y sincroniza este enfoque de forma bidireccional con el DOM.

Los llamadores que deseen cambiar de forma explícita el enfoque de entrada de componentes seleccionados de Blockly en la página deben usar las funciones de enfoque de este administrador.

El administrador es responsable de controlar los eventos de enfoque del DOM (que pueden surgir cuando los usuarios hacen clic en elementos de la página) y de garantizar que los IFocusableNodes correspondientes estén claramente marcados como destacados de forma activa o pasiva de la misma manera que se representaría con llamadas a focusNode().

Gesto Clase para un gesto.
Cuadrícula Es la clase de la cuadrícula de un espacio de trabajo.
HorizontalFlyout Clase para un menú flotante.
Entrada Es la clase de una entrada con campos opcionales.
InsertionMarkerPreviewer
LabelFlyoutInflater Es la clase responsable de crear etiquetas para los menús flotantes.
LineCursor Es la clase de un cursor de línea.
Marker Es la clase de un marcador. Se usa en la navegación con el teclado para guardar una ubicación en el AST de Blockly.
MarkerManager Clase para administrar los varios marcadores y el cursor en un lugar de trabajo.
Menú Una clase de menú básica.
MenuItem Es una clase que representa un elemento en un menú.
MetricsManager Es el administrador de todos los cálculos de métricas de Workspace.
Nombres Es la clase de una base de datos de nombres de entidades (variables, procedimientos, etcétera).
Navegador Es la clase responsable de determinar dónde debe moverse el enfoque en respuesta a los comandos de navegación del teclado.
Opciones Analiza las opciones especificadas por el usuario y usa valores predeterminados razonables cuando no se especifique el comportamiento.
RenderedConnection Es una clase para una conexión entre bloques que se pueden renderizar en la pantalla.
Barra de desplazamiento Clase para una barra de desplazamiento SVG pura. Esta técnica ofrece una barra de desplazamiento que funciona de forma garantizada, pero es posible que no se vea ni se comporte como las barras de desplazamiento del sistema.
ScrollbarPair Clase para un par de barras de desplazamiento. Horizontal y vertical.
SeparatorFlyoutInflater Es la clase responsable de crear separadores para los menús flotantes.
ShortcutRegistry Es una clase para el registro de combinaciones de teclas. Se supone que es un singleton. No debes crear una instancia nueva y solo debes acceder a esta clase desde ShortcutRegistry.registry.
Tema Es la clase de un tema.
ThemeManager Es una clase para almacenar y actualizar el tema y los componentes de la IU de un espacio de trabajo.
Toast Es una clase que permite mostrar y descartar notificaciones temporales.
Caja de herramientas Clase para una caja de herramientas. Crea el DOM de la caja de herramientas.
ToolboxCategory Es la clase de una categoría en una caja de herramientas.
ToolboxItem Es la clase de un elemento de la caja de herramientas.
ToolboxSeparator Es la clase de un separador de caja de herramientas. Es la línea visual delgada que aparece en la caja de herramientas. No se puede interactuar con este elemento.
Papelera Clase para un bote de basura.
UnattachedFieldError Representa un error en el que el campo intenta acceder a su bloque o a la información sobre él antes de que se haya adjuntado a dicho bloque.
VariableMap Es la clase de un mapa de variables. Contiene una estructura de datos de diccionario con tipos de variables como claves y listas de variables como valores. La lista de variables es del tipo que indica la clave.
VariableModel Es la clase de un modelo de variable. Contiene información de la variable, como el nombre, el ID y el tipo.
VerticalFlyout Clase para un menú flotante.
Workspace Es la clase de un espacio de trabajo. Es una estructura de datos que contiene bloques. No tiene IU y se puede crear sin cabeza.
WorkspaceAudio Es una clase para cargar, almacenar y reproducir audio en un lugar de trabajo.
WorkspaceDragger Clase para un elemento de arrastre de espacio de trabajo. Mueve el espacio de trabajo cuando se arrastra con el mouse o la función de toque.
WorkspaceNavigationPolicy Es un conjunto de reglas que controlan la navegación con el teclado desde un lugar de trabajo.
WorkspaceSvg Es la clase de un espacio de trabajo. Es un área en pantalla con un ícono de papelera, barras de desplazamiento, burbujas y arrastre opcionales.
ZoomControls Clase para un control de zoom.

Clases abstractas

Clase abstracta Descripción
Campo Es una clase abstracta para un campo editable.
Menú flotante Clase para un menú flotante.

Enumeraciones

Enumeration Descripción
ConnectionType Es una enumeración para el tipo de conexión o entrada.

Funciones

Función Descripción
getFocusManager() Función de conveniencia para FocusManager.getFocusManager.
hasBubble(obj) Es un protector de tipo que verifica si el objeto determinado es un IHasBubble.
hideChaff(opt_onlyClosePopups) Cerrar las herramientas de ayuda, los menús contextuales, las selecciones de menús desplegables, etcétera
inject(container, opt_options) Inyecta un editor de Blockly en el elemento de contenedor especificado (por lo general, un div).
isCopyable(obj)
isDeletable(obj) Devuelve si el objeto dado es un IDeletable.
isDraggable(obj) Muestra si el objeto dado es un IDraggable o no.
isIcon(obj) Protección de tipo que verifica si el objeto determinado es un IIcon.
isPaster(obj)
isRenderedElement(obj)
isSelectable(obj) Comprueba si el objeto determinado es un ISelectable.
isSerializable(obj) Es un protector de tipo que verifica si el objeto determinado es un ISerializable.
isVariableBackedParameterModel(param) Muestra si el objeto determinado es un contenedor de variables o no.
setLocale(locale)

Establece la configuración regional (es decir, los mensajes localizados, el texto del bloque, etc.) en la configuración regional determinada.

Esto no es útil ni necesario cuando se carga desde una etiqueta de secuencia de comandos, ya que los mensajes se insertan automáticamente en el objeto Blockly.Msg. Sin embargo, lo proporcionamos en los contextos de etiqueta de secuencia de comandos y sin etiqueta de secuencia de comandos para que tscompiler pueda crear correctamente nuestros archivos de definición de tipos.

Interfaces

Interfaz Descripción
BlocklyOptions Opciones de Blockly.
FieldCheckboxConfig Son las opciones de configuración para el campo de casilla de verificación.
FieldCheckboxFromJsonConfig Opciones de configuración de fromJson para el campo de casilla de verificación.
FieldConfig Son opciones de configuración adicionales para el campo base.
FieldDropdownFromJsonConfig Configuración de fromJson para el campo desplegable.
FieldImageConfig Opciones de configuración para el campo de imagen.
FieldImageFromJsonConfig Opciones de configuración de fromJson para el campo de imagen.
FieldLabelConfig Opciones de configuración para el campo de etiqueta.
FieldLabelFromJsonConfig Opciones de configuración de fromJson para el campo de etiqueta.
FieldNumberConfig Opciones de configuración para el campo de número.
FieldNumberFromJsonConfig Opciones de configuración de fromJson para el campo de número.
FieldTextInputFromJsonConfig Opciones de configuración de fromJson para el campo de entrada de texto.
FieldVariableConfig Opciones de configuración para el campo de variable.
FieldVariableFromJsonConfig Opciones de configuración de fromJson para el campo de variable.
IAutoHideable Es la interfaz de un componente que se puede ocultar automáticamente.
IBoundedElement Una interfaz de elemento delimitado.
IBubble Una interfaz de burbujas.
ICollapsibleToolboxItem Interfaz de un elemento de la caja de herramientas que se puede contraer.
IComponent Es la interfaz de un componente de Workspace que se puede registrar con ComponentManager.
IConnectionChecker Clase para la lógica de verificación del tipo de conexión.
IConnectionPreviewer Muestra "vistas previas" visuales de dónde se conectará un bloque si se suelta.
IContextMenu
ICopyable
IDeletable Es la interfaz de un objeto que se puede borrar.
IDeleteArea Es la interfaz de un componente que puede borrar un bloque o una burbuja que se coloca encima de él.
IDraggable Representa un objeto que se puede arrastrar.
IDragger
IDragStrategy
IDragTarget Es la interfaz de un componente con comportamiento personalizado cuando se arrastra un bloque o una burbuja sobre él o se sueltan encima.
IFlyout Interfaz para un menú flotante.
IFlyoutInflater
IFocusableNode Representa todo lo que puede tener enfoque de entrada.
IFocusableTree

Representa un árbol de elementos enfocables con su propio contexto de enfoque activo o pasivo.

Ten en cuenta que FocusManager controla el enfoque, y las implementaciones de árbol pueden tener como máximo un IFocusableNode enfocado a la vez. Si el árbol está enfocado, el nodo enfocado del árbol se considera "activo" ("pasivo" si otro árbol está enfocado).

El enfoque se comparte entre uno o más árboles, en los que cada árbol puede tener exactamente un nodo activo o pasivo (y solo puede existir un nodo activo en toda la página en un momento determinado). La idea del enfoque pasivo es proporcionar contexto a los usuarios sobre dónde se restablecerá su enfoque cuando vuelvan a navegar a un árbol enfocado anteriormente.

Ten en cuenta que, si se necesita el nodo enfocado actual del árbol (pasivo o activo), se puede usar FocusableTreeTraverser.findFocusedNode.

Ten en cuenta que, si se necesitan recuperar nodos específicos para este árbol, usa lookUpFocusableNode o FocusableTreeTraverser.findFocusableNodeFor.

IHasBubble
IIcon
IKeyboardAccessible Es una interfaz para un objeto que controla las combinaciones de teclas.
ImageProperties Definición de una opción de menú desplegable de imagen legible por humanos.
IMetricsManager Interfaz para un administrador de métricas.
IMovable Es la interfaz de un objeto que se puede mover.
INavigationPolicy Es un conjunto de reglas que especifican dónde debe continuar la navegación con el teclado.
IPaster Es un objeto que puede pegar datos en un lugar de trabajo.
IPositionable Interfaz de un componente que se ubica sobre el espacio de trabajo.
IRegistrable Es la interfaz de un componente de Blockly que se puede registrar.
IRenderedElement
ISelectable

Es la interfaz de un objeto que se puede seleccionar.

Por lo general, se espera que las implementaciones usen sus implementaciones de onNodeFocus() y onNodeBlur() para llamar a setSelected() con ellos mismos y nulo, respectivamente, para garantizar que las selecciones se actualicen correctamente y se active el evento de cambio de selección.

ISelectableToolboxItem Interfaz de un elemento de la caja de herramientas que se puede seleccionar.
ISerializable
IStyleable Interfaz de un objeto al que se puede agregar un estilo.
IToolbox Interfaz de una caja de herramientas.
IToolboxItem Interfaz de un elemento de la caja de herramientas.
IVariableBackedParameterModel Interfaz para un modelo de parámetros que contiene un modelo de variables.
IVariableMap

Los mapas de variables son objetos de contenedor responsables de almacenar y administrar el conjunto de variables a las que se hace referencia en un espacio de trabajo.

Cualquiera de estos métodos puede definir invariantes sobre qué nombres y tipos son legales y arrojar si no se cumplen.

IVariableModel
IVariableState Representa el estado de una variable determinada.
ToastOptions Opciones de visualización o configuración para una notificación emergente.

Espacios de nombres

Espacio de nombres Descripción
Bloquear
blockAnimations
blockRendering
browserEvents
burbujas
bumpObjects
portapapeles
CollapsibleToolboxCategory
comments
comunes
ComponentManager
constantes
ContextMenu
ContextMenuItems
ContextMenuRegistry
CSS
dialog
arrastrar
Eventos
Extensiones
fieldRegistry
geras
íconos
ICopyable
inputs
capas
libraryBlocks
MetricsManager
Nombres
Opciones
Procedimientos
registry
RenderedConnection
renderManagement
serialización
ShortcutItems
ShortcutRegistry
Tema
ThemeManager
Temas
thrasos
Toast Son opciones para determinar con qué agresividad los lectores de pantalla deben leer los avisos. Los valores corresponden a los de aria-live.
ToolboxCategory
ToolboxSeparator
Información sobre la herramienta
Touch
uiPosition
utils
Variables
VariablesDynamic
WidgetDiv
Xml
celos

Variables

Variable Descripción
Bloqueos Es una asignación de nombres de tipos de bloques a objetos de prototipos de bloques.
COLLAPSE_CHARS
COLLAPSED_FIELD_NAME
COLLAPSED_INPUT_NAME
config Es un objeto que contiene todos los valores de Blockly que esperamos que los desarrolladores puedan cambiar.
defineBlocksWithJsonArray Define bloques a partir de un array de definiciones de bloques JSON, como podrían generar las herramientas para desarrolladores de Blockly.
DELETE_VARIABLE_ID
DropDownDiv
getMainWorkspace Muestra el lugar de trabajo principal. Muestra el último lugar de trabajo principal que se usó (según el enfoque). Intenta no usar esta función, en especial si hay varias instancias de Blockly en una página.
getSelected Muestra el objeto que se puede copiar que se seleccionó actualmente.
INPUT_VALUE
JavaScript
Msg Es un diccionario de mensajes localizados.
NEXT_STATEMENT
OPPOSITE_TYPE
OUTPUT_VALUE
PREVIOUS_STATEMENT
PROCEDURE_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 procedimiento.
RENAME_VARIABLE_ID
setParentContainer Establece el contenedor superior. Este es el elemento contenedor en el que se renderizan WidgetDiv, dropDownDiv y Tooltip la primera vez que se llama a Blockly.inject. Este método es un NOP si se lo llama después del primer Blockly.inject.
svgResize Ajusta el tamaño de la imagen SVG para que cubra completamente el contenedor. Llama a esta función cuando la vista cambie de tamaño (p.ej., cuando se cambie el tamaño de una ventana o la orientación del dispositivo). Consulta workspace.resizeContents para cambiar el tamaño del lugar de trabajo cuando cambie el contenido (p.ej., cuando se agregue o quite un bloque). Registra la altura o el ancho de la imagen SVG.
TOOLBOX_AT_BOTTOM
TOOLBOX_AT_LEFT
TOOLBOX_AT_RIGHT
TOOLBOX_AT_TOP
VARIABLE_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.
VARIABLE_DYNAMIC_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.
VERSION Es la versión principal de Blockly. La secuencia de comandos de compilación (npm run build) anula esta constante y la reemplaza por el valor de la versión en package.json. El compilador Closure lo hace en la tarea gulp buildCompressed. Para compilaciones locales, puedes pasar --define='Blockly.VERSION=X.Y.Z' al compilador para anular esta constante.

Alias de tipo

Alias de tipo Descripción
FieldCheckboxValidator Es una función a la que se llama para validar los cambios en el valor del campo antes de que se establezcan.
FieldDropdownConfig Opciones de configuración para el campo desplegable.
FieldDropdownValidator Es una función a la que se llama para validar los cambios en el valor del campo antes de que se establezcan.
FieldNumberValidator Es una función a la que se llama para validar los cambios en el valor del campo antes de que se establezcan.
FieldTextInputConfig Son opciones de configuración para el campo de entrada de texto.
FieldTextInputValidator Es una función a la que se llama para validar los cambios en el valor del campo antes de que se establezcan.
FieldValidator Es una función a la que se llama para validar los cambios en el valor del campo antes de que se establezcan.
FieldVariableValidator Es una función a la que se llama para validar los cambios en el valor del campo antes de que se establezcan.
ICopyData
MenuGenerator Un array de opciones de menú o una función que genere un array de opciones de menú para FieldDropdown o sus elementos secundarios.
MenuGeneratorFunction Es una función que genera un array de opciones de menú para FieldDropdown o sus elementos secundarios.
MenuOption Una opción individual en el menú desplegable. Puede ser el literal de cadena separator para un elemento separador de menú o un array para elementos de menú de acción normales. En el último caso, el primer elemento es el valor legible por humanos (texto, objeto ImageProperties o elemento HTML) y el segundo es el valor independiente del idioma.
ReturnEphemeralFocus

Declaración de tipo para devolver el enfoque a FocusManager cuando se completa un flujo de IU efímero (como un diálogo).

Consulta FocusManager.takeEphemeralFocus para obtener más detalles.