Opção de grade
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O espaço de trabalho principal do Blockly pode ter uma grade. Os blocos podem ser
alinhados à grade, permitindo um layout mais limpo. Isso é útil principalmente em
aplicativos maiores com vários agrupamentos de código espalhados por uma
área grande.
As configurações da grade são definidas por um objeto que faz parte das
opções de
configuração do Blockly.
Exemplo:
var workspace = Blockly.inject('blocklyDiv',
{toolbox: document.getElementById('toolbox'),
grid:
{spacing: 20,
length: 3,
colour: '#ccc',
snap: true},
trashcan: true});
Espaçamento
A propriedade de grade mais importante é spacing
, que define a distância
entre os pontos da grade. O valor padrão é 0, o que resulta em nenhuma grade.
Confira exemplos de spacing
definidos como 10, 20 e 40:

Comprimento
A propriedade length
é um número que define a forma dos pontos da grade.
Um comprimento de 0 resulta em uma grade invisível (mas que ainda pode ser fixada), um comprimento de 1 (o valor padrão) resulta em pontos, um comprimento maior resulta em cruzes e um comprimento igual ou maior que o espaçamento resulta em papel
gráfico. Confira exemplos de length
definidos como 1, 5 e 20:

Cor
A propriedade colour
é uma string que define a cor dos pontos.
Observe a ortografia britânica. Use qualquer formato compatível com CSS, incluindo #f00
,
#ff0000
ou rgb(255, 0, 0)
. O valor padrão é #888
.
Confira exemplos de colour
definidos como #000
, #ccc
e #f00
:

Ajustar
A propriedade snap
é um booleano que define se os blocos precisam ser encaixados no
ponto de grade mais próximo quando colocados no espaço de trabalho. O valor padrão é false
.

Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-06-13 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-06-13 UTC."],[[["Blockly workspaces can have an optional grid to help organize blocks, especially in larger projects."],["The grid is customizable with properties like spacing, length, color, and snap, which are configured within Blockly's options."],["Grid spacing controls the distance between grid points, length determines the visual shape of grid points, color sets the color of the grid, and snap enables or disables block snapping to the grid."]]],["Blockly's workspace grid is configured via `spacing`, `length`, `colour`, and `snap` properties within the workspace configuration. `Spacing` defines the distance between grid points, with a default of 0 (no grid). `Length` shapes the grid points (dots, crosses, or graph paper). `Colour` sets the grid's color using CSS formats. `Snap` determines if blocks align to the grid, defaulting to `false`. Activating snap enables a more organized layout.\n"]]