Crea un espacio de trabajo

Puedes crear un espacio de trabajo e insertarlo en el DOM en una sola llamada, o simplemente crear un espacio de trabajo.

Inyección

Puedes crear un espacio de trabajo de Blockly y, luego, insertarlo en el DOM 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 objeto que contiene opciones de configuración.

Para obtener más información, consulta Crea un espacio de trabajo.

Creación directa

Puedes crear un espacio de trabajo directamente llamando a new Blockly.WorkspaceSvg(new Blockly.Options(options)). Cuando realices esta llamada, asegúrate de pasar tus opciones de configuración en una llamada a new Blockly.Options(options). El constructor WorkspaceSvg no puede aceptar tu objeto de opciones de configuración directamente.

Opciones de configuración

El objeto de configuración implementa Blockly.BlocklyOptions y tiene 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 Indica si los menús contextuales de los bloques incluyen un elemento para contraer o expandir bloques. El valor predeterminado es true si la caja de herramientas tiene categorías y false en otros casos.
comments booleano Indica si los menús contextuales de bloqueo incluyen un elemento para agregar o quitar comentarios. El valor predeterminado es true si la caja de herramientas tiene categorías,y false en caso contrario.
css booleano Si es falso, no se inyecta CSS (proporcionar CSS se convierte en responsabilidad del documento). La configuración predeterminada es true.
disable booleano Indica si los menús contextuales de los bloques incluyen un elemento para inhabilitar o habilitar bloques. El valor predeterminado es true si la caja de herramientas tiene categorías y false en caso contrario.
grid objeto Configura una cuadrícula a la que se pueden ajustar los bloques. Consulta Cuadrícula.
horizontalLayout booleano Si la caja de herramientas true es horizontal, si la caja de herramientas false es vertical. La configuración predeterminada es false.
maxBlocks número Es la 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 Es un mapa que asigna tipos de bloques a la cantidad máxima de bloques de ese tipo que se pueden crear. Los tipos no declarados se establecen de forma predeterminada en Infinity. Ejemplo: maxInstances: {'controls_if': 3, 'math_number': 42}
maxTrashcanContents número Es la cantidad máxima de elementos borrados que aparecerán en el menú desplegable de la papelera. '0' inhabilita la función. La configuración predeterminada es '32'.
media cadena Ruta de acceso desde la página (o el marco) al directorio de medios de Blockly. La configuración predeterminada es 'https://blockly-demo.appspot.com/static/media/'. Consulta Carpeta de medios.
modalInputs booleano Si true muestra editores modales para los campos de entrada de texto y sus subclases cuando se usan dispositivos móviles, y un editor intercalado en computadoras de escritorio. Si false, muestra un editor intercalado en computadoras y dispositivos móviles. La configuración predeterminada es true.
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 se indexa desde 0. El valor predeterminado es true.
plugins objeto Es un objeto que registra los nombres de los tipos de asignación de objetos en las clases de reemplazo o los nombres registrados de las clases de reemplazo. Consulta Cómo inyectar tu clase de reemplazo.
readOnly booleano Si es true, impide que el usuario realice ediciones. Suprime la caja de herramientas y la papelera. La configuración predeterminada es false. Consulta también setIsReadOnly y isReadOnly.
renderer cadena Determina el renderizador que usa Blockly. Los renderizadores preempaquetados incluyen 'geras' (el predeterminado), 'thrasos' y 'zelos' (un renderizador similar a Scratch). Para obtener información sobre los renderizadores personalizados, consulta Cómo crear renderizadores personalizados.
rtl booleano Si es true, refleja el editor (para la configuración regional en árabe o hebreo). Consulta la demostración de RTL. La configuración predeterminada es false.
scrollbars objeto o booleano Establece si el espacio de trabajo tiene barras de desplazamiento verticales u horizontales. 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 ningún tema, se usa el tema clásico de forma predeterminada. Consulta Temas.
toolbox cadena, XML o JSON Es la estructura de árbol de las categorías y los bloques disponibles para el usuario. Consulta cómo definir la caja de herramientas para obtener más información.
toolboxPosition cadena Si la caja de herramientas 'start' está en la parte superior (si es horizontal) o a la izquierda (si es vertical y LTR) o a la derecha (si es vertical y RTL). Si la caja de herramientas 'end' está en el lado opuesto La configuración predeterminada es 'start'.
trashcan booleano Muestra u oculta la papelera. El valor predeterminado es true si la caja de herramientas tiene categorías y false en caso contrario.
zoom objeto Configura el comportamiento del zoom. Consulta Zoom.