Arbeitsbereich erstellen

Sie können einen Arbeitsbereich erstellen und ihn in einem einzigen Aufruf in das DOM einfügen oder einfach nur einen Arbeitsbereich erstellen.

Injektion

Sie können einen Blockly-Arbeitsbereich erstellen und ihn mit einem Aufruf von Blockly.inject(location, options) in das DOM einfügen. Das erste Argument gibt Blockly an, wo der Arbeitsbereich in das DOM eingefügt werden soll. Das zweite Argument ist ein Objekt mit Konfigurationsoptionen.

Weitere Informationen finden Sie unter Arbeitsbereich erstellen.

Direkte Erstellung

Sie können einen Arbeitsbereich direkt erstellen, indem Sie new Blockly.WorkspaceSvg(new Blockly.Options(options)) aufrufen. Wenn du diesen Aufruf ausführst, musst du deine Konfigurationsoptionen in einem Aufruf an new Blockly.Options(options) übergeben. Der Konstruktor von WorkspaceSvg kann das Objekt mit den Konfigurationsoptionen nicht direkt akzeptieren.

Konfigurationsoptionen

Das Konfigurationsobjekt implementiert Blockly.BlocklyOptions und hat die folgenden Optionen. 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 Ob Blockkontextmenüs einen Punkt zum Minimieren oder Maximieren von Blöcken enthalten. Der Standardwert ist true, wenn die Toolbox Kategorien hat, andernfalls false.
comments boolean Ob Kontextmenüs für blockierte Inhalte ein Element zum Hinzufügen oder Entfernen von Kommentaren enthalten Der Standardwert ist true, wenn die Toolbox Kategorien hat, 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 Ob Kontextmenüs für Blockierungen einen Menüpunkt zum Deaktivieren oder Aktivieren von Blockierungen enthalten. Der Standardwert ist true, wenn die Toolbox Kategorien hat, 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}
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“.
media String Pfad von der Seite (oder dem Frame) zum Blockly-Medienverzeichnis. Die Standardeinstellung ist "https://blockly-demo.appspot.com/static/media/". Siehe Medienordner.
modalInputs boolean Wenn true auf Mobilgeräten modale Editoren für Texteingabefelder und ihre Unterklassen und auf Computern einen Inline-Editor anzeigt. Wenn false einen Inline-Editor sowohl auf Computern als auch auf Mobilgeräten anzeigt. Die Standardeinstellung ist true.
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.
plugins Objekt Ein Objekt, das Registriertypnamen zu Ersatzklassen oder den registrierten Namen von Ersatzklassen zuordnet. Weitere Informationen finden Sie unter Ersatzklasse einfügen.
readOnly boolean Wenn true, verhindern Sie, dass der Nutzer die Inhalte bearbeiten kann. Unterdrückt die Symbolleiste 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, der einem Scratch-Projekt ähnelt).
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.
zoom Objekt Hiermit wird das Zoomverhalten konfiguriert. Weitere Informationen finden Sie unter Zoom.