Opzioni di iniezione

Iniezione

Puoi inserire uno spazio di lavoro Blockly con una chiamata a Blockly.inject(location, options). Il primo argomento indica a Blockly dove inserire l'area di lavoro nel DOM. Il secondo argomento è un dizionario di coppie nome-valore utilizzato per la configurazione. Il codice di inserimento analizza il dizionario di opzioni in un'istanza di Blockly.Options.

Creazione diretta

Puoi anche creare uno spazio di lavoro direttamente chiamando Blockly.WorkspaceSvg(new Blockly.Options(options)). Tieni presente che devi chiamare new Blockly.Options(options) passando il dizionario di opzioni. Il costruttore dello spazio di lavoro si aspetta un'istanza di Blockly.Options, non un semplice dizionario di opzioni.

Il dizionario delle opzioni

Sono supportate le seguenti opzioni. Tieni presente che molte di queste opzioni cambiano il valore predefinito in base al fatto che la cassetta degli attrezzi fornita abbia o meno categorie.

Nome	Tipo	Descrizione
collapse	booleano	Consente di comprimere o espandere i blocchi. Il valore predefinito è true se la cassetta degli attrezzi ha categorie, false in caso contrario.
comments	booleano	Consente ai blocchi di avere 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	Consente di disattivare 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 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}
media	stringa	Percorso dalla pagina (o dal frame) alla directory multimediale di Blockly. Il valore predefinito è "https://blockly-demo.appspot.com/static/media/".
move	oggetto	Configura 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.
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" 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" è 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.
maxTrashcanContents	numero	Numero massimo di elementi eliminati che verranno visualizzati nel menu a scomparsa del cestino. "0" disattiva la funzionalità. Il valore predefinito è "32".
plugins	oggetto	Mappa del tipo di plug-in al nome del plug-in o della classe di plug-in registrato. Consulta la sezione sull'iniezione di sottoclassi.
zoom	oggetto	Configura il comportamento dello zoom. Vedi Zoom.