Injeção
Você pode 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-valor usado 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)). Observe que você precisa
chamar new Blockly.Options(options), transmitindo seu dicionário de opções. O
construtor do Workspace espera uma instância de Blockly.Options, não um dicionário
de opções básico.
Dicionário de opções
As opções a seguir são aceitas. Muitas dessas opções mudam o valor padrão dependendo se a caixa de ferramentas fornecida tem categorias ou não.
| Nome | Tipo | Descrição |
|---|---|---|
collapse
|
boolean | Permite que os blocos sejam recolhidos ou expandidos. O padrão será true se a caixa de ferramentas tiver categorias. Caso contrário, será false. |
comments
|
boolean | Permite que os blocos tenham comentários. O padrão será true se a
caixa de ferramentas tiver categorias. Caso contrário,será false. |
css
|
boolean | Se for falso, não injete o CSS. Fornecer o CSS passa a ser responsabilidade do documento. O valor padrão é true. |
disable
|
boolean | Permite que os blocos sejam desativados. O padrão será true se a
caixa de ferramentas tiver categorias. Caso contrário, será false. |
grid |
objeto | Configura uma grade à qual os blocos podem se ajustar. Consulte Grade. |
horizontalLayout
|
boolean | Se a caixa de ferramentas true for horizontal, se a caixa de ferramentas false for
vertical. Por padrão, é configurado como false. |
maxBlocks
|
number | Número máximo de blocos que podem ser criados. Isso é útil para
exercícios estudantis. O valor padrão é Infinity. |
maxInstances
|
objeto | Mapeie de tipos de bloco para o número máximo de blocos desse
tipo que podem ser criados. Os tipos não declarados usam o padrão
Infinity como padrão. |
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 dos usuários para se movimentar pelo espaço de trabalho. Consulte Mover. |
oneBasedIndex
|
boolean | Se as operações de lista e string true precisarem ser indexadas a partir de 1, e de false, de 0. O padrão é true. |
readOnly
|
boolean | Se definido como true, impeça que o usuário edite. Suprime a caixa de ferramentas
e a lixeira. O valor padrão é false. |
renderer
|
string | Determina o renderizador usado pelo blockly. Os renderizadores pré-empacotados incluem "geras" (padrão), "thrasos" e "zelos" (um renderizador semelhante a um rascunho). |
rtl
|
boolean | Se for true, reflita o editor (para localidades em árabe ou hebraico).
Consulte Demonstração de RTL. Por padrão, é configurado como false. |
scrollbars
|
objeto ou booleano | Define se o espaço de trabalho tem barras de rolagem verticais ou
horizontais. Usa 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 será true se a caixa de ferramentas tiver categorias. |
sounds |
boolean | Se for false, os sons serão desativados. O valor padrão é true. |
theme
|
Tema | Se nenhum tema for fornecido, o padrão será o tema clássico. Consulte Temas. |
toolbox
|
string, XML ou JSON | Estrutura de á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 superior (se horizontal), à esquerda (se
vertical e LTR) ou direita (se vertical e RTL). Se
a caixa de ferramentas "end" estiver no lado oposto. Por padrão, é configurado como "start". |
trashcan
|
boolean | Mostra ou oculta a lixeira. O padrão será true se a
caixa de ferramentas tiver categorias. Caso contrário, será false. |
maxTrashcanContents
|
number | Número máximo de itens excluídos que aparecerão no menu suspenso da lixeira. "0" desativa o recurso. O padrão é "32". |
plugins
|
objeto | Mapa do tipo de plug-in para o nome do plug-in ou da classe registrada. Consulte Como injetar subclasses. |
zoom |
objeto | Configura o comportamento do zoom. Consulte Zoom. |