Crea un workspace

Puoi creare uno spazio di lavoro e inserirlo nel DOM in una singola chiamata oppure solo creare 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 ulteriori informazioni, vedi Creare un workspace.

Creazione diretta

Puoi creare uno spazio di lavoro direttamente chiamando 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), poiché il costruttore WorkspaceSvg non può accettare direttamente l'oggetto delle opzioni di configurazione.

Opzioni di configurazione

L'oggetto di configurazione implementa Blockly.BlocklyOptions e dispone delle seguenti opzioni. Tieni presente che il valore predefinito di molte di queste opzioni cambia in base al fatto che la cassetta degli attrezzi fornita abbia o meno categorie.

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 cassetta degli attrezzi ha categorie, false in caso contrario.
comments booleano Indica se i menu contestuali dei blocchi includono un elemento per aggiungere o rimuovere i commenti. Il valore predefinito è true se la cassetta degli attrezzi ha categorie,false altrimenti.
css booleano Se false, non iniettare CSS (l'inserimento del 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 cassetta degli attrezzi ha categorie, false in caso contrario.
grid oggetto Configura una griglia a cui i blocchi possono essere agganciati. Consulta la sezione Griglia.
horizontalLayout booleano Se la cassetta degli attrezzi true è orizzontale, se la cassetta degli attrezzi 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 blocchi al numero massimo di blocchi di quel tipo che possono essere creati. Per i tipi non dichiarati, il valore predefinito è Infinity. Esempio: maxInstances: {'controls_if': 3, 'math_number': 42}
maxTrashcanContents numero Numero massimo di elementi eliminati che verranno visualizzati nel menu a scomparsa del cestino. "0" disattiva la funzionalità. Il valore predefinito è "32".
media stringa Percorso dalla pagina (o dal frame) alla directory multimediale di Blockly. Il valore predefinito è "https://blockly-demo.appspot.com/static/media/". Vedi Cartella multimediale.
modalInputs booleano Se true mostra gli editor modali per i campi di immissione di testo e i relativi sottoclassi sui dispositivi mobili e un editor in linea su computer. Se false mostra un editor in linea sia su computer che su dispositivo mobile. Il valore predefinito è true.
move oggetto Consente di configurare il comportamento relativo al modo in cui gli utenti possono spostarsi nello spazio di lavoro. Consulta la sezione Sposta.
oneBasedIndex booleano Se le operazioni con gli elenchi e le stringhe true devono avere come indice 1, se false ha come indice 0. Il valore predefinito è true.
plugins oggetto Un oggetto che mappa i nomi di tipo di registry alle classi di sostituzione o ai nomi registrati delle classi di sostituzione. Consulta Eseguire l'iniezione del corso sostitutivo.
readOnly booleano Se true, impedisci all'utente di apportare modifiche. Elimina la cassetta degli attrezzi e il cestino. Il valore predefinito è false.
renderer stringa Determina il renderer utilizzato da Blockly. I visualizzatori precompilati includono "geras" (il valore predefinito), "thrasos" e "zelos" (un visualizzatore simile a Scratch).
rtl booleano Se true, esegui il mirroring dell'editor (per le impostazioni internazionali in arabo o ebraico). Guarda la demo RTL. Il valore predefinito è false.
scrollbars oggetto o booleano Imposta se l'area di lavoro ha barre di scorrimento verticali o orizzontali. Prende 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, è equivalente a passare un oggetto con le proprietà horizontal e vertical impostate come valore. Il valore predefinito è true se la cassetta degli attrezzi ha categorie.
sounds booleano Se false, disattiva i suoni. Il valore predefinito è true.
theme Tema Se non viene fornito alcun tema, il valore predefinito è 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 Definire la cassetta degli attrezzi.
toolboxPosition stringa Se la cassetta degli attrezzi "start" è in alto (se orizzontale) o a sinistra (se verticale e LTR) o a destra (se verticale e RTL). Se la cassetta degli attrezzi "end" è sul lato opposto. Il valore predefinito è "start".
trashcan booleano Mostra o nasconde il cestino. Il valore predefinito è true se la cassetta degli attrezzi ha categorie, false in caso contrario.
zoom oggetto Configura il comportamento dello zoom. Vedi Zoom.