Questa pagina è stata tradotta dall'API Cloud Translation.

Opzioni di iniezione

Iniezione

Puoi inserire un'area di lavoro Blockly 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 dizionario di coppie nome-valore utilizzato per la configurazione. Il codice di inserimento analizza il dizionario delle opzioni in un'istanza di Blockly.Options.

Creazione diretta

Puoi anche creare direttamente un'area di lavoro chiamando Blockly.WorkspaceSvg(new Blockly.Options(options)). Tieni presente che devi chiamare new Blockly.Options(options), passando il dizionario delle opzioni. Il costruttore dell'area di lavoro prevede un'istanza di Blockly.Options, non un dizionario di opzioni semplici.

Dizionario delle opzioni

Sono supportate le seguenti opzioni. Tieni presente che il valore predefinito di molte di queste opzioni cambia a seconda che gli strumenti forniti includano o meno categorie.

Nome	Tipo	Descrizione
`collapse`	boolean	Consente la compressione o l'espansione dei blocchi. Il valore predefinito è `true` se la toolbox ha categorie, altrimenti `false`.
`comments`	boolean	Consente ai blocchi di avere commenti. Il valore predefinito è `true` se gli strumenti hanno categorie,in caso contrario`false`.
`css`	boolean	Se è falso, non inserire CSS (la responsabilità della fornitura di CSS diventa responsabilità del documento). Il valore predefinito è `true`.
`disable`	boolean	Consente la disattivazione dei blocchi. Il valore predefinito è `true` se gli strumenti hanno categorie, altrimenti `false`.
`grid`	oggetto	Consente di configurare una griglia a cui possono agganciarsi i blocchi. Vedi Griglia.
`horizontalLayout`	boolean	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 è possibile creare. 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 è possibile creare. Per impostazione predefinita, i tipi non dichiarati sono `Infinity`.
`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	Consente di configurare il comportamento degli utenti per spostarsi nell'area di lavoro. Vedi Spostare.
`oneBasedIndex`	boolean	Se le operazioni `true` con elenco e stringhe devono eseguire l'indicizzazione da `1`, se `false` indicizza da `0`. Il valore predefinito è `true`.
`readOnly`	boolean	Se `true`, non consentire all'utente di apportare modifiche. Elimina gli strumenti e il cestino. Il valore predefinito è `false`.
`renderer`	stringa	Determina il renderer utilizzato da blockly. I rendering predefiniti includono "geras" (valore predefinito), "thraso" e "zelos" (un renderer simile a un'immagine).
`rtl`	boolean	Se `true`, esegui il mirroring dell'editor (per le impostazioni internazionali arabe o ebraiche). Vedi la demo RTL. Il valore predefinito è `false`.
`scrollbars`	come un oggetto	Consente di impostare 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 è attivato. Se si passa un valore booleano, significa che è equivalente a passare un oggetto con proprietà `horizontal` e `vertical` impostate come quel valore. Il valore predefinito è `true` se gli strumenti contengono categorie.
`sounds`	boolean	Se `false`, disattiva i suoni. Il valore predefinito è `true`.
`theme`	Tema	Se non viene fornito alcun tema, viene utilizzato il tema classico. Consulta la sezione Temi.
`toolbox`	in formato XML, XML o JSON	Struttura ad albero di categorie e blocchi disponibili per l'utente. Per ulteriori informazioni, consulta la sezione Definire gli strumenti.
`toolboxPosition`	stringa	Se la toolbox `"start"` è in alto (se orizzontale) o a sinistra (se verticale e LTR) o a destra (se verticale e RTL). Se la casella degli strumenti `"end"` è sul lato opposto. Il valore predefinito è `"start"`.
`trashcan`	boolean	Mostra o nasconde il cestino. Il valore predefinito è `true` se gli strumenti hanno categorie, altrimenti `false`.
`maxTrashcanContents`	numero	Numero massimo di elementi eliminati che appariranno nel riquadro a scomparsa del cestino. "0" disattiva la funzionalità. Il valore predefinito è "32".
`plugins`	oggetto	Mappa del tipo di plug-in al nome della classe o del plug-in registrato. Consulta la sezione Inserimento di sottoclassi.
`zoom`	oggetto	Configura il comportamento dello zoom. Vedi Zoom.