blockly > Bloquear

Bloquear turma

Classe para um bloco. Normalmente, não é chamado diretamente, é preferível workspace.newBlock().

Signature:

export declare class Block implements IASTNodeLocation, IDeletable 

Implementa:IASTNodeLocation, IDeletable

Construtores

Construtor Modificadores Descrição
(construtor)(workspace, protótipoName, opt_id) Cria uma nova instância da classe Block

Propriedades

Propriedade Modificadores Tipo Descrição
childBlocks_ protected isto[]
collapsed_ protected boolean
COLLAPSED_FIELD_NAME

static

readonly

string O ID de idioma neutro fornecido ao campo recolhido.
COLLAPSED_INPUT_NAME

static

readonly

string O código neutro de idioma fornecido à entrada recolhida.
colour_ protected string Cor do bloco no formato "#RRGGBB".
compose? (p1: Bloquear) => nulo (Opcional) Uma função opcional que reconfigura o bloco com base no conteúdo da caixa de diálogo do mutator.
contextMenu boolean
dados string | nulo Dados de texto opcionais que têm ida e volta entre blocos e XML. Não tem efeito Podem ser usados por terceiros para metainformações.
decompose? (p1: Espaço de trabalho) => Bloquear (Opcional) Uma função opcional que preenche a caixa de diálogo do mutador com os componentes desse bloco.
destroy? () => nulo (Opcional) Um método opcional chamado durante o descarte.
domToMutation? (p1: Elemento) => nulo (Opcional) Um método de desserialização opcional para definir como desserializar o estado de mutação do XML. Isso precisa estar associado à definição do mutationToDom.
getDeveloperVariables? () => string[] (Opcional) Uma propriedade opcional para declarar variáveis do desenvolvedor. Retorna uma lista de nomes de variáveis para uso dos geradores. As variáveis de desenvolvedor nunca são mostradas ao usuário, mas são declaradas como variáveis globais no código gerado.
chapéu? string (Opcional) Nome do tipo de chapéu.
helpUrl string | Function | null String para ajuda sobre o bloco ou função que retorna um URL. Nulo se não tiver ajuda.
ícones IIcon[]
id string
init? () => nulo (Opcional) Um método opcional chamado durante a inicialização.
inputList Entrada[]
inputsInline? boolean (Opcional)
inputsInlineDefault? boolean (Opcional)
isInFlyout boolean
isInMutator boolean
isInsertionMarker_ protected boolean Verdadeiro se este bloco for um marcador de inserção.
loadExtraState? (em inglês) (p1: qualquer um) => nulo (Opcional) Um método de serialização opcional para definir como desserializar o estado extra do bloco (por exemplo, o estado de mutação) de algo compatível com JSON. Isso precisa estar associado à definição do saveExtraState.
mutateToDom? (em inglês) (...p1: any[]) => Elemento (Opcional) Um método de serialização opcional para definir como serializar o estado de mutação para XML. Isso precisa estar associado à definição do domToMutation.
nextConnection Conexão | nulo
mudar? ((p1: Abstract) => void) | null (Opcional) Um método de callback opcional para usar sempre que o espaço de trabalho pai do bloco mudar. Geralmente, isso só é chamado no construtor, na função de inicializador do tipo de bloco ou em uma função de inicializador de extensão.
outputConnection Conexão | nulo
outputShape_ protected número | nulo
parentBlock_ protected este | nulo
previousConnection Conexão | nulo
renderizado boolean | null
RTL boolean
saveExtraState? (doFullSerialization?: booleano) => qualquer um (Opcional) Um método de serialização opcional para definir como serializar o estado extra do bloco (por exemplo, o estado de mutação) para algo compatível com JSON. Isso precisa estar associado à definição do loadExtraState.
styleName_ protected string Nome do estilo do bloco.
suppressPrefixSuffix boolean | null Uma propriedade opcional para suprimir a adição de STATEMENT_PLACE e STATEMENT_SUFFIX ao código gerado.
dica Tooltip.TipInfo
tipo string
espaço de trabalho Espaço de trabalho

Métodos

Método Modificadores Descrição
addIcon(icon) Adiciona o ícone especificado ao bloco.
allInputsFilled(opt_shadowBlocksAreFilled) Verifica recursivamente se todas as entradas de instruções e valores estão preenchidas com blocos. Também verifica todos os seguintes blocos de instrução nesta pilha.
appendDummyInput(name) Anexa uma linha de entrada fictícia.
appendEndRowInput(name) Anexa uma entrada que termina a linha.
appendInput(input)

Anexa a linha de entrada fornecida.

Permite que entradas personalizadas sejam anexadas ao bloco.

appendStatementInput(name) Anexa uma linha de entrada da instrução.
appendValueInput(name) Anexa uma linha de entrada de valor.
bumpNeighbours() Quebrar blocos desconectados desalinhados. Dois blocos que não estão conectados não devem ficar alinhados na tela por coincidência.
dispose(healStack) (em inglês) Descarte este bloco.
disposeInternal() protected Descarta o bloco sem fazer o que é exigido pelo bloco superior. Por exemplo, não dispara eventos, desliga o bloco etc.
doInit_() protected Chama a função init() e manipula o disparo de eventos associados etc.
getChildren(ordered) Encontre todos os blocos que estão diretamente aninhados dentro desse. Inclui entradas de valor e instrução, bem como qualquer instrução a seguir. Exclui qualquer conexão em uma guia de saída ou qualquer instrução anterior. Os blocos são classificados opcionalmente por posição, de cima para baixo.
getColour() Veja a cor de um bloco.
getCommentText() Retorna o comentário nesse bloco (ou nulo se não houver comentário).
getDescendants(ordered) Encontre todos os blocos que estão, direta ou indiretamente, aninhados dentro desse. Inclui este bloco na lista. Inclui entradas de valor e instrução, bem como as declarações a seguir. Exclui qualquer conexão em uma guia de saída ou quaisquer instruções anteriores. Os blocos são classificados opcionalmente por posição, de cima para baixo.
getField(name) Retorna o campo nomeado de um bloco.
getFieldValue(name) Retorna o valor de linguagem neutra do campo especificado.
getHue() (link em inglês) Recebe o valor da matiz HSV de um bloco. Nulo se matiz não definido.
getIcon(type)
getIcons()
getInheritedDisabled() Descubra se o bloqueio está desativado ou não devido aos pais. A propriedade desativada do próprio bloco não é considerada.
getInput(name) Busca o objeto de entrada nomeado.
getInputsInline() Descubra se as entradas de valores estão organizadas horizontalmente ou verticalmente.
getInputTargetBlock(name) Busca o bloco anexado à entrada nomeada.
getInputWithBlock(block) Retorna a entrada que se conecta ao bloco especificado.
getNextBlock() Retorna o próximo bloco de instrução diretamente conectado a este bloco.
getOutputShape() Acessa a forma de saída do bloco.
getParent() Retorna o bloco pai ou nulo se esse bloco estiver no nível superior. O bloco pai é o bloco conectado à conexão anterior (para um bloco de instrução) ou o bloco conectado à conexão de saída (para um bloco de valor).
getPreviousBlock() Retorna o bloco conectado à conexão anterior.
getRelativeToSurfaceXY(). Retorna as coordenadas do canto superior esquerdo desse bloco em relação à origem da superfície de desenho (0,0), em unidades de espaço de trabalho.
getRootBlock() Retorne o bloco mais acima da árvore desse bloco. Ele será retornado se o bloco estiver no nível superior.
getStyleName() Receba o nome do estilo do bloco.
getSurroundParent() Return the parent block that surrounds the current block, or null if this block has no surrounding block. Um bloco pai pode ser apenas a instrução anterior, enquanto o bloco ao redor é uma instrução if, manter uma repetição etc.
getTooltip() Retorna o texto da dica para este bloco.
getVars() Retorna todas as variáveis referenciadas por este bloco.
hasIcon(type)
initModel() Chame initModel em todos os campos do bloco. Pode ser chamado mais de uma vez. É preciso chamar initModel ou initSvg depois da criação de um bloco e antes da primeira interação com ele. As interações incluem ações da IU (por exemplo, clicar e arrastar) e disparar eventos (por exemplo, criar, excluir e alterar).
isCollapsed() Descubra se o bloco está recolhido ou não.
isDeletable() Descubra se este bloqueio pode ser excluído ou não.
isDisposed() Retorna se esse bloco foi descartado ou excluído.
isDuplicatable() Descubra se o bloqueio é duplicado ou não. Se a duplicação do bloco e dos descendentes colocar esse bloco acima da capacidade do espaço de trabalho, esse bloco não poderá ser duplicado. Se a duplicação do bloco e dos descendentes colocar qualquer tipo em maxInstances, esse bloco não poderá ser duplicado.
isEnabled() Descubra se o bloqueio está ativado ou não.
isInsertionMarker() Descubra se este bloco é ou não um marcador de inserção.
isOwnDeletable() Retorne se a propriedade deletável deste bloco é verdadeira ou falsa.
isOwnEditable() Retorne se a propriedade editável deste bloco é verdadeira ou falsa.
isShadow() Descubra se este bloco é um bloco sombra ou não.
jsonInit(json) Inicialize esse bloco usando uma descrição JSON compatível com várias plataformas e internacionalização.
mixin(mixinObj, opt_disableCheck) Adicione chaves/valores da mixinObj a esse objeto em bloco. Por padrão, esse método vai verificar se as chaves em mixinObj não vão substituir os valores existentes no bloco, incluindo os valores do protótipo. Isso oferece algum seguro contra incompatibilidades de mixin / extensão com futuros recursos de bloqueio. Essa verificação pode ser desativada transmitindo "true" como o segundo argumento.
moveBy(dx, dy, reason) Mover um bloco por um deslocamento relativo.
moveInputBefore(name, refName) Mova uma entrada nomeada para um local diferente neste bloco.
moveNumberedInputBefore(inputIndex, refIndex) Mova uma entrada numerada para um local diferente neste bloco.
removeIcon(type) Remove o ícone cujo getType corresponde ao tipo iconType do bloco.
removeInput(name, opt_quiet) Remova uma entrada deste bloco.
renameVarById(oldId, newId) Notificação de que uma variável está sendo renomeada. Se o ID corresponder a uma das variáveis desse bloco, renomeie-o.
setCollapsed(collapsed) Defina se o bloco será recolhido ou não.
setColour(colour) Mudar a cor de um bloco.
setCommentText(text) Define o texto do comentário deste bloco.
setDeletable(deletable) Defina se este bloqueio pode ser excluído ou não.
setEditable(editable) Defina se o bloco é editável ou não.
setEnabled(enabled) Define se o bloqueio será ativado ou não.
setFieldValue(newValue, name) Define o valor do campo especificado para este bloco.
setHelpUrl(url) (link em inglês) Defina o URL da página de ajuda deste bloco.
setInputsInline(newBoolean) Defina se as entradas de valores são organizadas horizontalmente ou verticalmente.
setMovable(movable) Defina se este bloco pode ser movido ou não.
setMutator(_mutator) Atribua a esse bloco uma caixa de diálogo mutator.
setNextStatement(newBoolean, opt_check) Define se outro bloco pode encadear na parte inferior deste bloco.
setOnChange(onchangeFn) Define uma função de callback para uso sempre que o espaço de trabalho pai do bloco muda, substituindo qualquer gerenciador onchange anterior. Geralmente, isso só é chamado no construtor, na função de inicializador do tipo de bloco ou em uma função de inicializador de extensão.
setOutput(newBoolean, opt_check) Defina se esse bloco retorna um valor.
setOutputShape(outputShape) Define a forma de saída do bloco.
setPreviousStatement(newBoolean, opt_check) Define se este bloco pode encadear na parte de baixo de outro bloco.
setStyle(blockStyleName) Define os valores de estilo e cor de um bloco.
setTooltip(newTip) Define a dica para esse bloco.
setWarningText(_text, _opt_id) Define o texto de aviso deste bloco.
toDevString()

Esse método retorna uma string que descreve o bloco em termos do desenvolvedor (tipo e ID; somente em inglês).

Destinado a ser usado em registros e erros do console. Se você precisar de uma string que use o idioma nativo do usuário (incluindo texto de bloco, valores de campo e blocos filhos), use [toString()].

toString(opt_maxLength, opt_emptyToken) Crie uma representação de texto legível deste bloco e dos filhos.
unplug(opt_healStack) (em inglês) Desconecte esse bloco do bloco superior. Se esse bloco for uma declaração, você poderá reconectar o bloco abaixo com o bloco em cima.