Inyección
Puedes insertar un lugar 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 inyección analiza el diccionario de opciones en una instancia de Blockly.Options.
Creación directa
También puedes llamar a Blockly.WorkspaceSvg(new Blockly.Options(options)) para crear un lugar de trabajo directamente. Ten en cuenta que debes llamar a new Blockly.Options(options) y pasar el diccionario de opciones; el constructor del lugar de trabajo espera una instancia de Blockly.Options, no un diccionario de opciones básicas.
El diccionario de opciones
Se admiten las siguientes opciones. Ten en cuenta que varias de estas opciones cambian su valor predeterminado en función de si la caja de herramientas proporcionada tiene categorías o no.
| Nombre | Tipo | Descripción |
|---|---|---|
collapse
|
boolean | Permite contraer o expandir bloques. El valor predeterminado es true si la caja de herramientas tiene categorías. De lo contrario, es false. |
comments
|
boolean | Permite que los bloques tengan comentarios. El valor predeterminado es true si la caja de herramientas tiene categorías, de lo contrario, es false. |
css
|
boolean | Si es falso, no inyectes CSS (proporcionar CSS se convierte en responsabilidad del documento). La configuración predeterminada es true. |
disable
|
boolean | Permite inhabilitar los bloques. El valor predeterminado es true si la caja de herramientas tiene categorías; de lo contrario, es false. |
grid |
objeto | Configura una cuadrícula a la que se pueden ajustar los bloques. Consulta Cuadrícula. |
horizontalLayout
|
boolean | Si la caja de herramientas de true es horizontal, si la de false es vertical. La configuración predeterminada es false. |
maxBlocks
|
número | Cantidad máxima de bloques que se pueden crear. Es ú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. El valor predeterminado de los tipos no declarados es Infinity. |
media
|
cadena | Ruta de acceso desde la página (o marco) al directorio de contenido multimedia de Blockly.
La configuración predeterminada es "https://blockly-demo.appspot.com/static/media/". |
move
|
objeto | Configura el comportamiento que define cómo los usuarios pueden moverse por el lugar de trabajo. Consulta Mover. |
oneBasedIndex
|
boolean | Si las operaciones de strings y listas true deben indexarse desde 1, si el índice false es desde 0. El valor predeterminado es true. |
readOnly
|
boolean | Si el valor es true, evita que el usuario edite el elemento. Suprime la caja
de herramientas y la papelera. La configuración predeterminada es false. |
renderer
|
cadena | Determina el procesador que usa Blockly. Los procesadores empaquetados previamente incluyen “geras” (la opción predeterminada), “thrasos” y “zelos” (un procesador similar al de cero). |
rtl
|
boolean | Si el valor es true, duplica el editor (para configuraciones regionales en árabe o hebreo).
Consulta Demostración de escritura de derecha a izquierda. La configuración predeterminada es false. |
scrollbars
|
objeto o 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 configuradas como ese valor. El valor predeterminado es true si la caja de herramientas tiene categorías. |
sounds |
boolean | Si es false, inhabilita los sonidos. La configuración predeterminada es true. |
theme
|
Tema | Si no se proporciona ninguno, se establece de forma predeterminada en el tema clásico. Consulta Temas. |
toolbox
|
una cadena, XML o JSON | Estructura de árbol de categorías y bloques disponibles para el usuario Consulta Definición de la caja de herramientas para obtener más información. |
toolboxPosition
|
cadena | Si la caja de herramientas de "start" está en la parte superior (si es horizontal) o a la izquierda (si es vertical y de izquierda a derecha) o a la derecha (si es vertical y de derecha a izquierda). Si la caja de herramientas "end" está en el lado opuesto. La configuración predeterminada es "start". |
trashcan
|
boolean | Oculta o muestra la papelera. El valor predeterminado es true si la caja de herramientas tiene categorías; de lo contrario, es false. |
maxTrashcanContents
|
número | Cantidad máxima de elementos eliminados que aparecerán en el menú flotante de la papelera. "0" inhabilita la función. La configuración predeterminada es “32”. |
plugins
|
objeto | Asignación del tipo de complemento al nombre del complemento o la clase de complemento registrado. Consulta Cómo insertar subclases. |
zoom |
objeto | Configura el comportamiento del zoom. Consulta Zoom. |