Injektionsoptionen

Injektion

Sie können einen Blockly-Arbeitsbereich mit einem Aufruf von Blockly.inject(location, options) einfügen. Das erste Argument gibt Blockly an, wo der Arbeitsbereich in das DOM eingefügt werden soll. Das zweite Argument ist ein Wörterbuch mit Namen/Wert-Paaren, das für die Konfiguration verwendet wird. Der Injection-Code parst das Options-Dictionary in eine Instanz von Blockly.Options.

Direkte Erstellung

Sie können einen Arbeitsbereich auch direkt erstellen, indem Sie Blockly.WorkspaceSvg(new Blockly.Options(options)) aufrufen. Sie müssen new Blockly.Options(options) aufrufen und das Options-Dictionary übergeben. Der Konstruktor für den Arbeitsbereich erwartet eine Instanz von Blockly.Options, kein Options-Dictionary.

Das Optionswörterbuch

Die folgenden Optionen werden unterstützt. Hinweis: Bei einigen dieser Optionen ändert sich der Standardwert je nachdem, ob die bereitgestellte Toolbox Kategorien enthält oder nicht.

Name	Typ	Beschreibung
`collapse`	boolean	Hiermit können Blöcke minimiert oder maximiert werden. Der Standardwert ist `true`, wenn die Toolbox Kategorien enthält, andernfalls `false`.
`comments`	boolean	Ermöglicht Kommentare zu Blöcken. Der Standardwert ist `true`, wenn die Toolbox Kategorien enthält, andernfalls `false`.
`css`	boolean	Wenn „false“ festgelegt ist, wird kein CSS eingefügt. Die Bereitstellung von CSS ist dann Aufgabe des Dokuments. Die Standardeinstellung ist `true`.
`disable`	boolean	Hiermit können Blöcke deaktiviert werden. Der Standardwert ist `true`, wenn die Toolbox Kategorien enthält, andernfalls `false`.
`grid`	Objekt	Hiermit wird ein Raster konfiguriert, an das Blöcke angedockt werden können. Siehe Raster.
`horizontalLayout`	boolean	Wenn die `true`-Toolbox horizontal ist, ist die `false`-Toolbox vertikal. Die Standardeinstellung ist `false`.
`maxBlocks`	Zahl	Maximale Anzahl von Blöcken, die erstellt werden können. Nützlich für Übungen von Schülern und Studenten. Die Standardeinstellung ist `Infinity`.
`maxInstances`	Objekt	Zuordnung von Blocktypen zur maximalen Anzahl von Blöcken dieses Typs, die erstellt werden können. Für nicht deklarierte Typen wird standardmäßig `Infinity` verwendet. Beispiel: `maxInstances: {'controls_if': 3, 'math_number': 42}`
`media`	String	Pfad von der Seite (oder dem Frame) zum Blockly-Medienverzeichnis. Die Standardeinstellung ist `"https://blockly-demo.appspot.com/static/media/"`.
`move`	Objekt	Hiermit wird konfiguriert, wie sich Nutzer im Arbeitsbereich bewegen können. Weitere Informationen finden Sie unter Verschieben.
`oneBasedIndex`	boolean	Ob Listen- und Stringvorgänge für `true` von `1` oder für `false` von `0` aus indexiert werden sollen. Die Standardeinstellung ist `true`.
`readOnly`	boolean	Wenn `true`, verhindern Sie, dass der Nutzer die Inhalte bearbeiten kann. Unterdrückt die Toolbox und den Papierkorb. Die Standardeinstellung ist `false`.
`renderer`	String	Bestimmt den von blockly verwendeten Renderer. Zu den vorkonfigurierten Renderern gehören „geras“ (Standard), „thrasos“ und „zelos“ (ein Renderer ähnlich wie Scratch).
`rtl`	boolean	Wenn `true`, wird der Editor gespiegelt (für die Sprachen Arabisch oder Hebräisch). RTL-Demo Die Standardeinstellung ist `false`.
`scrollbars`	Objekt oder boolescher Wert	Hiermit wird festgelegt, ob der Arbeitsbereich vertikale oder horizontale Bildlaufleisten hat. Es wird ein Objekt verwendet, bei dem das Attribut `horizontal` festlegt, ob das horizontale Scrollen aktiviert ist, und das Attribut `vertical` festlegt, ob das vertikale Scrollen aktiviert ist. Wenn ein boolescher Wert übergeben wird, entspricht das dem Übergeben eines Objekts, bei dem sowohl die `horizontal`- als auch die `vertical`-Eigenschaft auf diesen Wert festgelegt sind. Der Standardwert ist `true`, wenn die Toolbox Kategorien enthält.
`sounds`	boolean	Bei `false` werden Töne deaktiviert. Die Standardeinstellung ist `true`.
`theme`	Design	Wenn kein Design angegeben ist, wird standardmäßig das klassische Design verwendet. Weitere Informationen finden Sie unter Designs.
`toolbox`	String, XML oder JSON	Baumstruktur der Kategorien und Blöcke, die für den Nutzer verfügbar sind. Weitere Informationen finden Sie unter Toolbox definieren.
`toolboxPosition`	String	Ob die `"start"`-Toolbox oben (bei horizontaler Ausrichtung), links (bei vertikaler Ausrichtung und LTR) oder rechts (bei vertikaler Ausrichtung und RTL) angezeigt wird. Wenn sich die `"end"`-Toolbox auf der gegenüberliegenden Seite befindet. Die Standardeinstellung ist `"start"`.
`trashcan`	boolean	Blendet den Papierkorb ein oder aus. Der Standardwert ist `true`, wenn die Toolbox Kategorien enthält, andernfalls `false`.
`maxTrashcanContents`	Zahl	Maximale Anzahl der gelöschten Elemente, die im Ausklappmenü des Papierkorbs angezeigt werden. Mit „0“ wird die Funktion deaktiviert. Die Standardeinstellung ist „32“.
`plugins`	Objekt	Zuordnung des Plug-in-Typs zum Namen des registrierten Plug-ins oder der registrierten Plug-in-Klasse. Weitere Informationen finden Sie unter Unterklassen einschleusen.
`zoom`	Objekt	Hiermit wird das Zoomverhalten konfiguriert. Weitere Informationen finden Sie unter Zoom.