blockly

Pacote blockly

Classes

Aula Descrição
ASTNode Classe para um nó AST. É recomendável usar um dos métodos createNode em vez de criar um nó diretamente.
BasicCursor Classe para um cursor básico. Isso permite que o usuário chegue a todos os nós no AST ao pressionar "next" (avançar) ou "Previous" (anterior).
Bloquear Classe para um bloco. Normalmente, não é chamado diretamente, é preferível usar workspace.newBlock().
BlockSvg Classe para a representação SVG de um bloco. Normalmente, não é chamado diretamente, é preferível usar workspace.newBlock().
CodeGenerator Classe para um gerador de código que traduz os blocos para um idioma.
CollapsibleToolboxCategory Classe para uma categoria em uma caixa de ferramentas que pode ser recolhida.
ComponentManager Administrador de todos os itens registrados no espaço de trabalho.
Conexão Classe para uma conexão entre blocos.
ConnectionChecker Classe para lógica de verificação do tipo de conexão.
ConnectionDB Banco de dados de conexões. As conexões são armazenadas na ordem do componente vertical. Dessa forma, conexões em uma área podem ser procuradas rapidamente usando uma pesquisa binária.
ContextMenuRegistry Classe para o registro de itens do menu de contexto. Ele deve ser um Singleton. Não crie uma nova instância e só acesse essa classe em ContextMenuRegistry.registry.
Cursor Classe para um cursor. Um cursor controla como um usuário navega no Blockly AST.
DeleteArea Classe abstrata para um componente que pode excluir um bloco ou uma bolha solta sobre ele.
DragTarget Classe abstrata para um componente com comportamento personalizado quando um bloco ou balão é arrastado ou solto sobre ele.
FieldCheckbox Classe para um campo da caixa de seleção.
FieldDropdown Classe para um campo suspenso editável.
FieldImage Classe para uma imagem em um bloco.
FieldLabel Classe para um campo de texto não editável e não serializável.
FieldLabelSerializable Classe para um campo de texto serializável e não editável.
FieldNumber Classe para um campo numérico editável.
FieldTextInput Classe para um campo de texto editável.
FieldVariable Classe para o campo suspenso de uma variável.
FlyoutButton Classe para um botão ou rótulo no menu suspenso.
FlyoutMetricsManager Calcula métricas para um espaço de trabalho do menu suspenso. As métricas são usadas principalmente para dimensionar as barras de rolagem do menu suspenso.
Gesto Classe para um gesto.
Grade Classe para a grade de um espaço de trabalho.
HorizontalFlyout Classe para um menu suspenso.
Entrada Classe para uma entrada com campos opcionais.
InsertionMarkerManager Classe que controla atualizações nas conexões durante as ações de arrastar. Ele é o principal responsável por encontrar a conexão qualificada mais próxima e destacá-la ou desmarcá-la conforme necessário durante uma ação de arrastar.
InsertionMarkerPreviewer
Marker Classe de um marcador. É usado na navegação pelo teclado para salvar um local no Blockly AST.
MarkerManager Classe para gerenciar vários marcadores e o cursor em um espaço de trabalho.
Menu Uma classe de menu básica.
MenuItem Classe que representa um item em um menu.
MetricsManager O gerente de todos os cálculos de métricas do espaço de trabalho.
Nomes Classe para um banco de dados de nomes de entidade (variáveis, procedimentos etc.).
Opções Analisa as opções especificadas pelo usuário, usando padrões razoáveis quando o comportamento não é especificado.
RenderedConnection Classe para uma conexão entre blocos que podem ser renderizados na tela.
Barra de rolagem Classe para uma barra de rolagem SVG pura. Essa técnica oferece uma barra de rolagem que certamente vai funcionar, mas que pode não parecer ou se comportar como as barras de rolagem do sistema.
ScrollbarPair Classe para um par de barras de rolagem. Horizontal e vertical.
ShortcutRegistry Classe para o registro de atalhos do teclado. Ele deve ser um Singleton. Não crie uma nova instância e só acesse essa classe em ShortcutRegistry.registry.
TabNavigateCursor Um cursor para navegar entre campos navegáveis por tabulação.
Tema Classe para um tema.
ThemeManager Classe para armazenar e atualizar o tema e os componentes da interface de um espaço de trabalho.
Caixa de ferramentas Classe para uma caixa de ferramentas. Cria o DOM da caixa de ferramentas.
ToolboxCategory Classe para uma categoria em uma caixa de ferramentas.
ToolboxItem Classe para um item na caixa de ferramentas.
ToolboxSeparator Classe para um separador de caixa de ferramentas. Essa é a linha visual fina que aparece na caixa de ferramentas. Não é possível interagir com este item.
Lixeira Classe para uma lixeira.
UnattachedFieldError Representa um erro em que o campo está tentando acessar o bloco ou as informações sobre o bloco antes de realmente ser anexado a esse bloco.
VariableMap Classe para um mapa de variáveis. Contém uma estrutura de dados de dicionário com tipos de variáveis como chaves e listas de variáveis como valores. A lista de variáveis é do tipo indicado pela chave.
VariableModel Classe para um modelo de variável. Mantém as informações da variável, incluindo nome, ID e tipo.
VerticalFlyout Classe para um menu suspenso.
Espaço de trabalho Classe para um espaço de trabalho. Essa é uma estrutura de dados que contém blocos. Não há interface e pode ser criada sem comando.
WorkspaceAudio Classe para carregar, armazenar e reproduzir áudio para um espaço de trabalho.
WorkspaceDragger Classe para um arrastador do espaço de trabalho. Ele move o espaço de trabalho quando está sendo arrastado por um mouse ou toque.
WorkspaceSvg Classe para um espaço de trabalho. Essa é uma área na tela com a opção de lixeira, barras de rolagem, balões e recursos de arrastar.
ZoomControls Classe para controles de zoom.

Classes abstratas

Classe abstrata Descrição
Campo Classe abstrata para um campo editável.
Suspenso Classe para um menu suspenso.

Enumerações

Enumeração Descrição
ConnectionType Enumeração do tipo de conexão ou entrada.

Funções

Função Descrição
hasBubble(obj) Proteção de tipo que verifica se o objeto fornecido é um IHasBubble.
hideChaff(opt_onlyClosePopups) Fechar dicas de ferramentas, menus de contexto, seleções de menus suspensos etc.
inject(container, opt_options) Injete um editor do Blockly no elemento de contêiner especificado (geralmente um div).
isCopyable(obj)
isDeletable(obj) Retorna se o objeto fornecido é um IDeleable.
isDraggable(obj) Retorna se o objeto fornecido é um IDraggable ou não.
isIcon(obj) Uma proteção de tipo que verifica se o objeto fornecido é um IIcon.
isPaster(obj)
isSelectable(obj) Verifica se o objeto fornecido é um ISelectable.
isSerializable(obj) Proteção de tipo que verifica se o objeto especificado é ISerializável.
isVariableBackedParameterModel(param) Retorna se o objeto especificado é ou não um detentor de variável.
setLocale(locale)

Define a localidade (ou seja, as mensagens localizadas/block-text/etc) para a localidade especificada.

Isso não é útil/necessário no carregamento de uma tag de script, porque as mensagens são automaticamente agrupadas no objeto Blockly.Msg. Mas nós o fornecemos nos contextos script-tag e non-script-tag para que o tscompiler possa criar corretamente nossos arquivos de definição de tipo.

Interfaces

Interface Descrição
BlocklyOptions Opções do Blockly.
FieldCheckboxConfig Opções de configuração para o campo da caixa de seleção.
FieldCheckboxFromJsonConfig Opções de configuração do fromJson para o campo da caixa de seleção.
FieldConfig Opções extras de configuração para o campo base.
FieldDropdownFromJsonConfig fromJson para o campo suspenso.
FieldImageConfig Opções de configuração para o campo de imagem.
FieldImageFromJsonConfig Opções de configuração do fromJson para o campo de imagem.
FieldLabelConfig Opções de configuração para o campo do rótulo.
FieldLabelFromJsonConfig Opções de configuração do fromJson para o campo do identificador.
FieldNumberConfig Opções de configuração para o campo numérico.
FieldNumberFromJsonConfig Opções de configuração do fromJson para o campo numérico.
FieldTextInputFromJsonConfig Opções de configuração do fromJson para o campo de entrada de texto.
FieldVariableConfig Opções de configuração para o campo de variável.
FieldVariableFromJsonConfig Opções de configuração do fromJson para o campo de variável.
IASTNodeLocation Uma interface de localização de nó AST.
IASTNodeLocationSvg (link em inglês) Uma interface SVG de localização de nó AST.
IASTNodeLocationWithBlock Um local de nó AST que tem um bloco associado.
IAutoHideable Interface para um componente que pode ser ocultado automaticamente.
IBoundedElement Uma interface de elemento limitado.
IBubble Uma interface em balão.
ICollapsibleToolboxItem Interface para um item da caixa de ferramentas que pode ser recolhida.
IComponent A interface para um componente do espaço de trabalho que pode ser registrado com o ComponentManager.
IConnectionChecker Classe para lógica de verificação do tipo de conexão.
IConnectionPreviewer Mostra "prévias" visuais de onde um bloco será conectado se for solto.
IContextMenu
ICopyable
IDeletable A interface de um objeto que pode ser excluído.
IDeleteArea Interface para um componente que pode excluir um bloco ou uma bolha que é solto sobre ele.
IDraggable Representa um objeto que pode ser arrastado.
IDragger
IDragStrategy
IDragTarget Interface para um componente com comportamento personalizado quando um bloco ou balão é arrastado ou solto sobre ele.
IFlyout Interface para um menu suspenso.
IHasBubble
IIcon
IKeyboardAccessible Uma interface para um objeto que processa atalhos de teclado.
IMetricsManager Interface para um gerenciador de métricas.
IMovable É a interface de um objeto móvel.
IPaster Um objeto que pode colar dados em um espaço de trabalho.
IPositionable Interface para um componente posicionado na parte de cima do espaço de trabalho.
IRegistrable A interface para um componente do Blockly que pode ser registrado.
ISelectable A interface de um objeto selecionável.
ISelectableToolboxItem Interface para um item da caixa de ferramentas que pode ser selecionado.
ISerializable
IStyleable Interface para um objeto ao qual um estilo pode ser adicionado.
IToolbox Interface para uma caixa de ferramentas.
IToolboxItem Interface para um item na caixa de ferramentas.
IVariableBackedParameterModel Interface para um modelo de parâmetro que contém um modelo de variável.

Namespaces

Namespace Descrição
ASTNode
Bloquear
blockAnimations
blockRendering
browserEvents
balões
bumpObjects
área de transferência
CollapsibleToolboxCategory
comments
common
ComponentManager
constants
ContextMenu
ContextMenuItems
ContextMenuRegistry
CSS
caixa de diálogo
arrastar
Eventos
Extensões
fieldRegistry
geras
ícones
ICopyable
entradas
InsertionMarkerManager
libraryBlocks
MetricsManager
Nomes
Opções
Procedimentos
registry
RenderedConnection
renderManagement
serialização
ShortcutItems
ShortcutRegistry
Tema
ThemeManager
Temas
thrasos (em inglês)
ToolboxCategory
ToolboxSeparator
Dica
Toque
uiPosition
utils
Variáveis
VariablesDynamic
WidgetDiv
XML
zelos (em inglês)

Variáveis

Variável Descrição
Bloqueios Um mapeamento de nomes de tipos de blocos para bloquear objetos de protótipos.
COLLAPSE_CHARS
COLLAPSED_FIELD_NAME
COLLAPSED_INPUT_NAME
config Objeto que contém todos os valores no Blockly que esperamos que os desenvolvedores possam alterar.
defineBlocksWithJsonArray Defina blocos com base em uma matriz de definições de blocos JSON, como os gerados pelas Ferramentas para desenvolvedores do Blockly.
DELETE_VARIABLE_ID
DropDownDiv
getMainWorkspace Retorna o espaço de trabalho principal. Retorna o último espaço de trabalho principal usado (com base no foco). Tente não usar essa função, principalmente se houver várias instâncias do Blockly em uma página.
getSelected Retorna o objeto copiável selecionado no momento.
INPUT_VALUE
JavaScript
Mensagem Um dicionário de mensagens localizadas.
NEXT_STATEMENT
OPPOSITE_TYPE
OUTPUT_VALUE
PREVIOUS_STATEMENT
PROCEDURE_CATEGORY_NAME String para uso no atributo "custom" de uma categoria no XML da caixa de ferramentas. Essa string indica que a categoria precisa ser preenchida dinamicamente com blocos de procedimento.
RENAME_VARIABLE_ID
setParentContainer Defina o contêiner pai. Esse é o elemento de contêiner em que WidgetDiv, dropDownDiv e dicas são renderizados na primeira vez que o Blockly.inject é chamado. Esse método é um NOP se for chamado após o primeiro Blockly.inject.
svgResize Dimensione a imagem SVG para preencher completamente o contêiner. Chame esse evento quando a visualização realmente mudar de tamanho (por exemplo, em uma mudança de redimensionamento de janela/orientação do dispositivo). Consulte workspace.resizeContents para redimensionar o espaço de trabalho quando o conteúdo for alterado (por exemplo, quando um bloco for adicionado ou removido). Registre a altura/largura da imagem SVG.
TOOLBOX_AT_BOTTOM
TOOLBOX_AT_LEFT
TOOLBOX_AT_RIGHT
TOOLBOX_AT_TOP
VARIABLE_CATEGORY_NAME String para uso no atributo "custom" de uma categoria no XML da caixa de ferramentas. Essa string indica que a categoria precisa ser preenchida dinamicamente com blocos de variáveis.
VARIABLE_DYNAMIC_CATEGORY_NAME String para uso no atributo "custom" de uma categoria no XML da caixa de ferramentas. Essa string indica que a categoria precisa ser preenchida dinamicamente com blocos de variáveis.
VERSÃO Versão principal do Blockly. Essa constante é substituída pelo script de build (npm run build) para o valor da versão em package.json. Isso é feito pelo closure Compiler na tarefa buildComzip do gulp. Para builds locais, você pode passar --define='Blockly.VERSION=X.Y.Z' ao compilador para substituir essa constante.

Aliases de tipos

Tipo de alias Descrição
FieldCheckboxValidator Uma função chamada para validar alterações no valor do campo antes que elas sejam definidas.
FieldDropdownConfig Opções de configuração para o campo suspenso.
FieldDropdownValidator Uma função chamada para validar alterações no valor do campo antes que elas sejam definidas.
FieldNumberValidator Uma função chamada para validar alterações no valor do campo antes que elas sejam definidas.
FieldTextInputConfig Opções de configuração para o campo de entrada de texto.
FieldTextInputValidator Uma função chamada para validar alterações no valor do campo antes que elas sejam definidas.
FieldValidator Uma função chamada para validar alterações no valor do campo antes que elas sejam definidas.
FieldVariableValidator Uma função chamada para validar alterações no valor do campo antes que elas sejam definidas.
ICopyData
MenuGenerator Uma matriz de opções de menu ou uma função que gera uma matriz de opções de menu para FieldDropdown ou descendentes.
MenuGeneratorFunction Uma função que gera uma matriz de opções de menu para FieldDropdown ou descendentes.
MenuOption Uma opção individual no menu suspenso. O primeiro elemento é o valor legível (texto ou imagem), e o segundo é o valor neutro de linguagem.