Injeção
É possível injetar um espaço de trabalho do Blockly com uma chamada para
Blockly.inject(location, options). O primeiro argumento informa ao Blockly onde
injetar o espaço de trabalho no DOM. O segundo argumento é um dicionário de
pares de nome e valor usados para configuração. O código de injeção analisa o
dicionário de opções em uma instância de Blockly.Options.
Criação direta
Também é possível criar um espaço de trabalho diretamente chamando
Blockly.WorkspaceSvg(new Blockly.Options(options)). É necessário
chamar new Blockly.Options(options), transmitindo o dicionário de opções. O
construtor do espaço de trabalho espera uma instância de Blockly.Options, não um dicionário
de opções simples.
Dicionário de opções
As seguintes opções são compatíveis. Várias dessas opções mudam o valor padrão com base na existência ou não de categorias na caixa de ferramentas.
| Nome | Tipo | Descrição |
|---|---|---|
collapse
|
booleano | Permite que os blocos sejam recolhidos ou abertos. O padrão é true se a caixa de ferramentas tiver categorias. Caso contrário, o padrão é false. |
comments
|
booleano | Permite que os blocos tenham comentários. O padrão é true se a
caixa de ferramentas tiver categorias. Caso contrário,o padrão será false. |
css
|
booleano | Se for falso, não injete CSS. O CSS será de
responsabilidade do documento. O valor padrão é true. |
disable
|
booleano | Permite que os blocos sejam desativados. O padrão é true se a
caixa de ferramentas tiver categorias. Caso contrário, o padrão será false. |
grid |
objeto | Configura uma grade à qual os blocos podem se encaixar. Consulte Grade. |
horizontalLayout
|
booleano | Se a caixa de ferramentas true estiver horizontal, se a caixa de ferramentas false estiver
na vertical. O valor padrão é false. |
maxBlocks
|
number | Número máximo de blocos que podem ser criados. Útil para
exercícios dos estudantes. O valor padrão é Infinity. |
maxInstances
|
objeto | Mapeia os tipos de bloco para o número máximo de blocos desse
tipo que podem ser criados. Os tipos não declarados são definidos como
Infinity por padrão. Exemplo:
maxInstances: {'controls_if': 3, 'math_number': 42} |
media
|
string | Caminho da página (ou frame) para o diretório de mídia do Blockly.
O padrão é
"https://blockly-demo.appspot.com/static/media/". |
move
|
objeto | Configura o comportamento de como os usuários podem se mover pelo espaço de trabalho. Consulte Mover. |
oneBasedIndex
|
booleano | Se as operações de lista e string true precisarem ser indexadas a partir de 1,
se false for indexado a partir de 0. O padrão é true. |
readOnly
|
booleano | Se true, impede que o usuário edite. Suprime a
caixa de ferramentas e a lixeira. O padrão é false. |
renderer
|
string | Determina o renderizador usado pelo Blockly. Os renderizadores pré-empacotados incluem "geras" (o padrão), "thrasos" e "zelos" (um renderizador semelhante a scratch). |
rtl
|
booleano | Se true, espelhe o editor (para localidades em árabe ou hebraico).
Consulte a demonstração de RTL. O valor padrão é false. |
scrollbars
|
objeto ou booleano | Define se o espaço de trabalho tem barras de rolagem verticais ou horizontais. Recebe um objeto em que a propriedade horizontal
determina se a rolagem horizontal está ativada e a
propriedade vertical determina se a rolagem vertical está
ativada. Se um booleano for transmitido, ele será equivalente a
transmitir um objeto com as propriedades horizontal e vertical
definidas como esse valor. O padrão é true se a
caixa de ferramentas tiver categorias. |
sounds |
booleano | Se false, desativa os sons. O padrão é true. |
theme
|
Tema | O padrão será o tema clássico se nenhum tema for fornecido. Consulte Temas. |
toolbox
|
string, XML ou JSON | Estrutura em árvore de categorias e blocos disponíveis para o usuário. Consulte Como definir a caixa de ferramentas para mais informações. |
toolboxPosition
|
string | Se a caixa de ferramentas "start" estiver na parte de cima (se for horizontal) ou à esquerda (se
for vertical e LTR) ou à direita (se for vertical e RTL). Se
a caixa de ferramentas "end" estiver no lado oposto. O valor padrão é "start". |
trashcan
|
booleano | Mostra ou oculta a lixeira. O padrão é true se a
caixa de ferramentas tiver categorias. Caso contrário, o padrão será false. |
maxTrashcanContents
|
number | Número máximo de itens excluídos que vão aparecer no menu suspenso da lixeira. "0" desativa o recurso. O padrão é "32". |
plugins
|
objeto | Mapeamento do tipo de plug-in para o nome do plug-in registrado ou da classe de plug-in. Consulte Injetar subclasses. |
zoom |
objeto | Configura o comportamento de zoom. Consulte Zoom. |