Inyección
Puedes insertar un espacio de trabajo de Blockly con una llamada a Blockly.inject(location, options). El primer argumento le indica a Blockly dónde insertar el espacio de trabajo en el DOM. El segundo argumento es un diccionario de
pares nombre-valor que se usa para la configuración. El código de inserción analiza el diccionario de opciones en una instancia de Blockly.Options.
Creación directa
También puedes crear un espacio de trabajo directamente si llamas a Blockly.WorkspaceSvg(new Blockly.Options(options)). Ten en cuenta que debes llamar a new Blockly.Options(options) y pasarle tu diccionario de opciones. El constructor del espacio de trabajo espera una instancia de Blockly.Options, no un diccionario de opciones sin formato.
El diccionario de opciones
Se admiten las siguientes opciones. Ten en cuenta que varias de estas opciones cambian su valor predeterminado según si la caja de herramientas proporcionada tiene categorías o no.
| Nombre | Tipo | Descripción |
|---|---|---|
collapse
|
booleano | Permite contraer o expandir bloques. El valor predeterminado es true si la caja de herramientas tiene categorías, false de lo contrario. |
comments
|
booleano | Permite que los bloques tengan comentarios. El valor predeterminado es true si la caja de herramientas tiene categorías,false de lo contrario. |
css
|
booleano | Si es falso, no insertes CSS (proporcionar CSS se convierte en la responsabilidad del
documento). La configuración predeterminada es true. |
disable
|
booleano | Permite inhabilitar los bloqueos. El valor predeterminado es true si la caja de herramientas tiene categorías, false de lo contrario. |
grid |
objeto | Configura una cuadrícula a la que los bloques pueden ajustarse. Consulta Cuadrícula. |
horizontalLayout
|
booleano | Si la caja de herramientas de true es horizontal, si la caja de herramientas de false es vertical. La configuración predeterminada es false. |
maxBlocks
|
número | Es la cantidad máxima de bloques que se pueden crear. Útil para los ejercicios de los estudiantes. La configuración predeterminada es Infinity. |
maxInstances
|
objeto | Asigna los tipos de bloques a la cantidad máxima de bloques de ese tipo que se pueden crear. Los tipos no declarados tienen el valor predeterminado Infinity. Ejemplo: maxInstances: {'controls_if': 3, 'math_number': 42} |
media
|
string | Es la ruta de acceso de la página (o el marco) al directorio de medios de Blockly.
La configuración predeterminada es "https://blockly-demo.appspot.com/static/media/". |
move
|
objeto | Configura el comportamiento de cómo los usuarios pueden moverse por el espacio de trabajo. Consulta Mover. |
oneBasedIndex
|
booleano | Si las operaciones de lista y cadena de true deben indexarse desde 1, si false indexa desde 0. El valor predeterminado es true. |
readOnly
|
booleano | Si es true, evita que el usuario realice ediciones. Suprime la caja de herramientas y la papelera. La configuración predeterminada es false. |
renderer
|
string | Determina el renderizador que usa blockly. Los renderizadores empaquetados previamente incluyen "geras" (el predeterminado), "thrasos" y "zelos" (un renderizador similar a Scratch). |
rtl
|
booleano | Si es true, refleja el editor (para configuraciones regionales de árabe o hebreo).
Consulta la demo de RTL. La configuración predeterminada es false. |
scrollbars
|
objeto o valor booleano | Establece si el lugar de trabajo tiene barras de desplazamiento horizontales o verticales. Toma un objeto en el que la propiedad horizontal determina si el desplazamiento horizontal está habilitado y la propiedad vertical determina si el desplazamiento vertical está habilitado. Si se pasa un valor booleano, equivale a pasar un objeto con las propiedades horizontal y vertical establecidas como ese valor. El valor predeterminado es true si la caja de herramientas tiene categorías. |
sounds |
booleano | Si es false, inhabilita los sonidos. La configuración predeterminada es true. |
theme
|
Tema | Si no se proporciona un tema, se usa el tema clásico de forma predeterminada. Consulta Temas. |
toolbox
|
cadena, XML o JSON | Estructura de árbol de categorías y bloques disponibles para el usuario. Consulta cómo definir la caja de herramientas para obtener más información. |
toolboxPosition
|
string | Si la caja de herramientas de "start" está en la parte superior (si es horizontal), a la izquierda (si es vertical y LTR) o a la derecha (si es vertical y RTL). Si la caja de herramientas de "end" está en el lado opuesto. La configuración predeterminada es "start". |
trashcan
|
booleano | Oculta o muestra el ícono de papelera. El valor predeterminado es true si la caja de herramientas tiene categorías, false de lo contrario. |
maxTrashcanContents
|
número | Es la cantidad máxima de elementos borrados que aparecerán en el menú flotante del basurero. "0" inhabilita la función. El valor predeterminado es “32”. |
plugins
|
objeto | Es un mapa del tipo de complemento al nombre del complemento registrado o de la clase de complemento. Consulta Cómo insertar subclases. |
zoom |
objeto | Configura el comportamiento de zoom. Consulta Zoom. |