Crea un workspace

Puoi creare uno spazio di lavoro e inserirlo nel DOM in una singola chiamata oppure creare solo uno spazio di lavoro.

Iniezione

Puoi creare uno spazio di lavoro Blockly e inserirlo nel DOM con una chiamata a Blockly.inject(location, options). Il primo argomento indica a Blockly dove inserire lo spazio di lavoro nel DOM. Il secondo argomento è un oggetto contenente opzioni di configurazione.

Per saperne di più, vedi Creare uno spazio di lavoro.

Creazione diretta

Puoi creare uno spazio di lavoro direttamente chiamando il numero new Blockly.WorkspaceSvg(new Blockly.Options(options)). Quando effettui questa chiamata, assicurati di passare le opzioni di configurazione in una chiamata a new Blockly.Options(options). Il costruttore WorkspaceSvg non può accettare direttamente l'oggetto delle opzioni di configurazione.

Opzioni di configurazione

L'oggetto di configurazione implementa Blockly.BlocklyOptions e ha le seguenti opzioni. Tieni presente che diverse di queste opzioni modificano il proprio valore predefinito a seconda che la casella degli strumenti fornita contenga categorie o meno.

Nome Tipo Descrizione
collapse booleano Indica se i menu contestuali dei blocchi includono un elemento per comprimere o espandere i blocchi. Il valore predefinito è true se la casella degli strumenti ha categorie, false altrimenti.
comments booleano Se i menu contestuali dei blocchi includono un elemento per aggiungere o rimuovere i commenti. Il valore predefinito è true se la casella degli strumenti ha categorie,false altrimenti.
css booleano Se è false, non inserire CSS (fornire CSS diventa responsabilità del documento). Il valore predefinito è true.
disable booleano Indica se i menu contestuali dei blocchi includono un elemento per disattivare o attivare i blocchi. Il valore predefinito è true se la casella degli strumenti ha categorie, false altrimenti.
grid oggetto Configura una griglia a cui possono agganciarsi i blocchi. Vedi Griglia.
horizontalLayout booleano Se la casella degli strumenti true è orizzontale, se la casella degli strumenti false è verticale. Il valore predefinito è false.
maxBlocks numero Numero massimo di blocchi che possono essere creati. Utile per gli esercizi degli studenti. Il valore predefinito è Infinity.
maxInstances oggetto Mappa dai tipi di blocco al numero massimo di blocchi di quel tipo che possono essere creati. I tipi non dichiarati sono impostati per impostazione predefinita su Infinity. Esempio: maxInstances: {'controls_if': 3, 'math_number': 42}
maxTrashcanContents numero Numero massimo di elementi eliminati che verranno visualizzati nel menu a comparsa del cestino. '0' disattiva la funzionalità. Il valore predefinito è '32'.
media stringa Percorso dalla pagina (o dal frame) alla directory dei contenuti multimediali di Blockly. Il valore predefinito è 'https://blockly-demo.appspot.com/static/media/'. Vedi Cartella multimediale.
modalInputs booleano Se true mostra editor modali per i campi di input di testo e le relative sottoclassi sui dispositivi mobili e un editor incorporato sul computer. Se false mostra un editor in linea sia su computer che su dispositivi mobili. Il valore predefinito è true.
move oggetto Configura il comportamento per il modo in cui gli utenti possono spostarsi nello spazio di lavoro. Vedi Sposta.
oneBasedIndex booleano Se le operazioni su elenchi e stringhe devono essere indicizzate da 1, se false deve essere indicizzato da 0.true Il valore predefinito è true.
plugins oggetto Un registro di mappatura degli oggetti che associa i nomi dei tipi alle classi di sostituzione o ai nomi registrati delle classi di sostituzione. Vedi Inserire la classe sostitutiva.
readOnly booleano Se true, impedisci all'utente di apportare modifiche. Elimina la casella degli strumenti e il cestino. Il valore predefinito è false. Vedi anche setIsReadOnly e isReadOnly.
renderer stringa Determina il renderer utilizzato da Blockly. I renderer preconfigurati includono 'geras' (quello predefinito), 'thrasos' e 'zelos' (un renderer simile a Scratch). Per informazioni sui renderer personalizzati, vedi Creare renderer personalizzati.
rtl booleano Se true, esegui il mirroring dell'editor (per le impostazioni internazionali in arabo o ebraico). Vedi la demo RTL. Il valore predefinito è false.
scrollbars oggetto o booleano Imposta se l'area di lavoro ha barre di scorrimento verticali o orizzontali. Accetta un oggetto in cui la proprietà horizontal determina se lo scorrimento orizzontale è abilitato e la proprietà vertical determina se lo scorrimento verticale è abilitato. Se viene passato un valore booleano, equivale a passare un oggetto con le proprietà horizontal e vertical impostate su quel valore. Il valore predefinito è true se la casella degli strumenti ha categorie.
sounds booleano Se false, disattiva i suoni. Il valore predefinito è true.
theme Tema Se non viene fornito alcun tema, viene utilizzato il tema classico. Vedi Temi.
toolbox stringa, XML o JSON Struttura ad albero delle categorie e dei blocchi disponibili per l'utente. Per ulteriori informazioni, consulta la sezione Definizione della tavolozza.
toolboxPosition stringa Se la casella degli strumenti 'start' si trova in alto (se orizzontale) o a sinistra (se verticale e LTR) o a destra (se verticale e RTL). Se la cassetta degli attrezzi 'end' si trova sul lato opposto. Il valore predefinito è 'start'.
trashcan booleano Mostra o nasconde il cestino. Il valore predefinito è true se la casella degli strumenti ha categorie, false altrimenti.
zoom oggetto Configura il comportamento di zoom. Vedi Zoom.