Entradas inline e externas

As entradas podem ser renderizadas inline ou externamente. Isso controla se os conectores para entradas de valor são renderizados dentro do bloco (inline) ou na borda externa (externa), bem como se as entradas são renderizadas na mesma ou em linhas diferentes.

Variações inline e externas do bloco "count with x from value to value do statement". Na variação inline, o bloco tem duas linhas: a de cima tem "count with x from value to value" e a de baixo tem "do statement". As entradas de valor parecem peças de quebra-cabeça cortadas de dentro da linha de cima. Na variação externa, o bloco tem quatro linhas: "count with x", "from value", "to value" e "do statement". As entradas de valor estão nas extremidades da segunda e da terceira linhas e parecem conectores de quebra-cabeça femininos.

A definição de bloco pode especificar um booleano opcional que controla se as entradas são in-line ou não.

JSON

{
  // ...,
  "inputsInline": true
}

JavaScript

init: function() {
  // ...
  this.setInputsInline(true);
}

Quando esse booleano é definido como true (entradas inline):

  • Os conectores para entradas de valor são renderizados dentro do bloco.
  • As entradas de declaração são renderizadas na própria linha.
  • Entradas de marcador de posição, fim de linha e valor são renderizadas na mesma linha, exceto quando uma entrada após uma instrução ou entrada de fim de linha é renderizada em uma nova linha.

Quando definido como false (entradas externas):

  • Os conectores para entradas de valor são renderizados na borda externa do bloco.
  • Todas as entradas são renderizadas na própria linha, exceto uma entrada de fim de linha que segue uma entrada fictícia e é renderizada na mesma linha que ela.

Se você estiver com dificuldade para visualizar isso, crie blocos nas Ferramentas para desenvolvedores do Blockly e escolha configurações diferentes no menu suspenso inputs (automatic, external, inline).

Se esse booleano não for definido, o Blockly usará algumas heurísticas para adivinhar qual modo é melhor. Supondo que o Blockly faça a escolha certa, é preferível deixar esse campo indefinido, já que diferentes traduções de idiomas podem ter modos diferentes automaticamente. Consulte o exemplo de "set %1 to %2" (entradas externas) e "put %2 in %1" (entradas inline) em Ordem dos tokens de interpolação.

Use entradas inline quando um bloco provavelmente tiver entradas pequenas, como números. O usuário pode ativar ou desativar essa opção no menu de contexto.