blockly > Block

Classe de bloco

Classe para um bloco. Normalmente, não é chamado diretamente, workspace.newBlock() é a melhor opção.

Signature:

export declare class Block 

Construtores

Construtor	Modificadores	Descrição
(constructor)(workspace, prototypeName, opt_id)		Cria uma nova instância da classe Block.

Propriedades

Propriedade	Modificadores	Tipo	Descrição
childBlocks_	protected	this[]
collapsed_	protected	booleano
COLLAPSED_FIELD_NAME	static readonly	string	O ID neutro em relação ao idioma atribuído ao campo fechado.
COLLAPSED_INPUT_NAME	static readonly	string	O ID neutro em relação ao idioma atribuído à entrada recolhida.
colour_	protected	string	Cor do bloco no formato "#RRGGBB".
compose?		(rootBlock: Block) => void	(Opcional) Um método opcional que reconfigura o bloco com base no conteúdo da caixa de diálogo do modificador.
contextMenu		booleano
dados		string | null	Dados de texto opcionais que fazem viagens de ida e volta entre blocos e XML. Não tem efeito Pode ser usado por terceiros para metainformações.
decompor?		(workspace: Workspace) => Bloquear	(Opcional) Uma função opcional que preenche o menu suspenso do modificador com blocos que representam a configuração desse bloco.
destruição?		() => void	(Opcional) Um método opcional chamado durante a eliminação.
disposing	protected	booleano	O bloco atual está em processo de descarte?
domToMutation?		(p1: Element) => void	(Opcional) Um método de desserialização opcional para definir como desserializar o estado de mutação do XML. Isso precisa ser combinado com a definição de mutationToDom.
getDeveloperVariables?		() => string[]	(Opcional) Um método opcional para declarar variáveis do desenvolvedor, a serem usadas por geradores. As variáveis do 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 | (() => string) | null	String para ajuda de bloco ou função que retorna um URL. "Null" para "sem ajuda".
ícones		IIcon[]
id		string
init?		() => void	(Opcional) Um método opcional chamado durante a inicialização.
inputList		Entrada[]
inputsInline?		booleano	(Opcional)
inputsInlineDefault?		booleano	(Opcional)
isInFlyout		booleano
isInMutator		booleano
isInsertionMarker_	protected	booleano	Verdadeiro se este bloco for um marcador de inserção.
loadExtraState?		(p1: any) => void	(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 ser combinado com a definição de saveExtraState.
mutationToDom?		(...p1: any[]) => Elemento	(Opcional) Um método de serialização opcional para definir como serializar o estado da mutação em XML. Isso precisa ser combinado com a definição de domToMutation.
nextConnection		Conexão | null
onchange?		((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 é chamado apenas pelo construtor, pela função de inicialização do tipo de bloco ou por uma função de inicialização de extensão.
outputConnection		Conexão | null
outputShape_	protected	number | null
parentBlock_	protected	this | null
previousConnection		Conexão | null
renderizado	readonly	booleano	Este bloco é um BlockSVG?
RTL		booleano
saveExtraState?		(doFullSerialization?: boolean) => any	(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 ser combinado com a definição de loadExtraState.
styleName_	protected	string	Nome do estilo de bloco.
suppressPrefixSuffix		boolean | null	Uma propriedade opcional para suprimir a adição de STATEMENT_PREFIX e STATEMENT_SUFFIX ao código gerado.
Dica		Tooltip.TipInfo
type		string
workspace		Workspace

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 declaração e valor estão preenchidas com blocos. Também verifica todos os blocos de instrução seguintes nesta pilha.
appendDummyInput(name)		Adiciona uma linha de entrada fictícia.
appendEndRowInput(name)		Adiciona uma entrada que encerra a linha.
appendInput(input)		Anexa a linha de entrada especificada. Permite que entradas personalizadas sejam anexadas ao bloco.
appendStatementInput(name)		Anexar uma linha de entrada de instrução.
appendValueInput(name)		Anexa uma linha de entrada de valor.
bumpNeighbours()		Desloque os blocos desconectados. Dois blocos que não estão conectados não podem aparecer alinhados na tela.
dispose(healStack)		Descarte este bloco.
disposeInternal()	protected	Descarta esse bloco sem fazer as coisas necessárias no bloco de cima. Por exemplo, não aciona eventos, desconecta o bloco etc.
doInit_()	protected	Chama a função init() e processa o disparo de eventos associados etc.
getChildren(ordered)		Encontre todos os blocos que estão diretamente aninhados dentro deste. Inclui entradas de valor e instrução, além de qualquer instrução seguinte. Exclui qualquer conexão em uma guia de saída ou qualquer instrução anterior. Os blocos são classificados por posição, de cima para baixo.
getColour()		Recebe a cor de um bloco.
getCommentText()		Retorna o comentário sobre este bloco (ou nulo se não houver comentários).
getDescendants(ordered)		Encontre todos os blocos que estão aninhados diretamente ou indiretamente dentro deste. Inclui esse bloco na lista. Inclui entradas de valor e instrução, além de todas as instruções seguintes. Exclui qualquer conexão em uma guia de saída ou qualquer instrução anterior. Os blocos são classificados por posição, de cima para baixo.
getDisabledReasons()		Receba um conjunto de motivos para o bloqueio estar desativado, se houver. Se o bloco estiver ativado, o conjunto vai estar vazio.
getField(name)		Retorna o campo nomeado de um bloco.
getFields()		Retorna um gerador que fornece todos os campos no bloco. Um gerador que pode ser usado para iterar os campos no bloco.
getFieldValue(name)		Retorna o valor neutro em relação ao idioma do campo fornecido.
getHue()		Recebe o valor de matiz HSV de um bloco. Nulo se a matiz não estiver definida.
getIcon(type)
getIcons()
getInheritedDisabled()		Receba informações sobre se o bloqueio está desativado ou não devido a familiares responsáveis. A propriedade desativada do bloco não é considerada.
getInput(name)		Busca o objeto de entrada nomeado.
getInputsInline()		Recebe se as entradas de valor estão dispostas 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()		Receba a forma de saída do bloco.
getParent()		Retorna o bloco pai ou nulo se ele 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 do espaço de trabalho.
getRootBlock()		Retorna o bloco principal na árvore desse bloco. Ele vai retornar a si mesmo se o bloco estiver no nível superior.
getStyleName()		Receba o nome do estilo do bloco.
getSurroundParent()		Retorna o bloco pai que envolve o bloco atual ou nulo se ele não tiver um bloco ao redor. Um bloco pai pode ser apenas a instrução anterior, enquanto o bloco ao redor é uma instrução if, um loop while etc.
getTooltip()		Retorna o texto da dica do bloco.
getVars()		Retorna todas as variáveis referenciadas por este bloco.
hasDisabledReason(reason)		Verifica se o bloqueio está desativado no momento pelo motivo informado.
hasIcon(type)
initModel()		Chame initModel em todos os campos do bloco. Pode ser chamado mais de uma vez. O initModel ou o initSvg precisa ser chamado após a criação de um bloco e antes da primeira interação com ele. As interações incluem ações de interface (por exemplo, clicar e arrastar) e acionamento de eventos (por exemplo, criar, excluir e alterar).
isCollapsed()		Conferir se o bloco está recolhido ou não.
isDeletable()		Verifica se o bloco pode ser excluído ou não.
isDisposed()		Retorna se o bloco foi descartado / excluído.
isDuplicatable()		Verifica se o bloco pode ser duplicado ou não. Se a duplicação desse bloco e dos descendentes colocar esse bloco acima da capacidade do espaço de trabalho, ele não poderá ser duplicado. Se a duplicação desse bloco e dos descendentes colocar qualquer tipo sobre as maxInstances, esse bloco não poderá ser duplicado.
isEnabled()		Recebe se o bloco está ativado ou não. Um bloco é considerado ativado se não houver motivos para ele ser desativado. Um bloco ainda pode ser desativado por outros motivos, mesmo que o usuário tente ativá-lo manualmente, por exemplo, quando o bloco está em um local inválido.
isInsertionMarker()		Verifica se o bloco é um marcador de inserção ou não.
isOwnDeletable()		Retorna se a propriedade deletable do bloco é verdadeira ou falsa.
isOwnEditable()		Retorna se a propriedade editável do bloco é verdadeira ou falsa.
isShadow()		Verifica se o bloco é de sombra ou não.
jsonInit(json)		Inicialize esse bloco usando uma descrição JSON compatível com internacionalização e várias plataformas.
mixin(mixinObj, opt_disableCheck)		Adicione chaves/valores de mixinObj a esse objeto de bloco. Por padrão, esse método verifica se as chaves em mixinObj não vão substituir os valores atuais no bloco, incluindo os valores de protótipo. Isso oferece uma garantia contra incompatibilidades de mixin / extensão com recursos de bloco futuros. Essa verificação pode ser desativada transmitindo "true" como o segundo argumento.
moveBy(dx, dy, reason)		Mova 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 de ícone fornecido 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)		Define se o bloco está fechado ou não.
setColour(colour)		Mudar a cor de um bloco.
setCommentText(text)		Defina o texto do comentário deste bloco.
setDeletable(deletable)		Define se esse bloco pode ser excluído ou não.
setDisabledReason(disabled, reason)		Adicione ou remova um motivo para o bloqueio. Se um bloco tiver algum motivo para ser desativado, ele será considerado desativado. Um bloqueio pode ser desativado por vários motivos independentes ao mesmo tempo, como quando o usuário o desativa manualmente ou quando o bloqueio é inválido.
setEditable(editable)		Define se o bloco é editável ou não.
setFieldValue(newValue, name)		Define o valor do campo fornecido para este bloco.
setHelpUrl(url)		Defina o URL da página de ajuda desse bloco.
setInputsInline(newBoolean)		Defina se as entradas de valor são organizadas horizontalmente ou verticalmente.
setMovable(movable)		Define se esse bloco é móvel ou não.
setMutator(_mutator)		Dê a esse bloco uma caixa de diálogo de mutador.
setNextStatement(newBoolean, opt_check)		Define se outro bloco pode ser encadeado na parte de baixo deste bloco.
setOnChange(onchangeFn)		Define uma função de callback para usar sempre que o espaço de trabalho pai do bloco mudar, substituindo qualquer manipulador onchange anterior. Geralmente, isso é chamado apenas pelo construtor, pela função de inicialização do tipo de bloco ou por uma função de inicialização de extensão.
setOutput(newBoolean, opt_check)		Defina se esse bloco retorna um valor.
setOutputShape(outputShape)		Defina a forma de saída do bloco.
setPreviousStatement(newBoolean, opt_check)		Define se esse bloco pode ser encadeado na parte de baixo de outro bloco.
setStyle(blockStyleName)		Defina os valores de estilo e cor de um bloco.
setTooltip(newTip)		Define a dica de ferramenta para este bloco.
setWarningText(_text, _opt_id)		Defina o texto de aviso do bloco.
toDevString()		Esse método retorna uma string que descreve esse bloco em termos de desenvolvedor (nome e ID do tipo; somente em inglês). Destinado a ser usado em erros e registros 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 por humanos desse bloco e de todos os filhos.
unplug(opt_healStack)		Desconecte esse bloco do bloco superior. Se esse bloco for uma instrução, conecte o bloco abaixo com o bloco de cima.