blockly > Blockieren

Kurs blockieren

Klasse für einen Block. Wird normalerweise nicht direkt aufgerufen, wird „workspace.newBlock()“ bevorzugt.

Unterschrift:

export declare class Block implements IASTNodeLocation 

Implementierung:IASTNodeLocation

Konstruktoren

Konstruktor Modifikatoren Beschreibung
(Konstruktor)(Arbeitsbereich, PrototypName, opt_id) Erstellt eine neue Instanz der Block-Klasse

Attribute

Attribut Modifikatoren Typ Beschreibung
childBlocks_ protected dies[]
collapsed_ protected boolean
COLLAPSED_FIELD_NAME

static

readonly

String Die sprachneutrale ID für das minimierte Feld.
COLLAPSED_INPUT_NAME

static

readonly

String Die sprachneutrale ID, die der minimierten Eingabe zugewiesen wird.
colour_ protected String Farbe des Blocks in '#RRGGBB' Format.
komponieren? (p1: Blockieren) => voidm (Optional) Eine optionale Funktion, die den Block basierend auf dem Inhalt des Mutator-Dialogfelds neu konfiguriert.
contextMenu boolean
Daten String | null Optionale Textdaten, die zwischen Blöcken und XML wechseln. Hat keine Wirkung. Kann von Drittanbietern für Metainformationen verwendet werden.
zersetzen? (p1: Arbeitsbereich) => Blockieren (Optional) Eine optionale Funktion, die die Komponenten dieses Blocks in das Dialogfeld des Mutators füllt.
löschen? () => voidm (Optional) Eine optionale Methode, die während der Entsorgung aufgerufen wird.
entsorgen protected boolean Wird die aktuelle Sperrung gerade entsorgt?
domToMutation? (p1: Element) => voidm (Optional) Eine optionale Deserialisierungsmethode, mit der definiert wird, wie der Mutationsstatus aus XML deserialisiert wird. Dies muss mit der Definition von mutationToDom gekoppelt werden.
getDeveloperVariables? () => String[] (Optional) Eine optionale Eigenschaft zum Deklarieren von Entwicklervariablen. Gibt eine Liste von Variablennamen zur Verwendung durch Generatoren zurück. Entwicklervariablen werden dem Nutzer nie angezeigt, sondern als globale Variablen im generierten Code deklariert.
hat? String Optional: Name der Art von Hut.
helpUrl String | Funktion | null String für Blockhilfe oder Funktion, die eine URL zurückgibt. Null, wenn keine Hilfe benötigt wird.
Symbole IIcon[]
id String
init? () => voidm (Optional) Eine optionale Methode, die während der Initialisierung aufgerufen wird.
inputList Eingabe[]
inputsInline? boolean (Optional)
inputsInlineDefault? boolean (Optional)
isInFlyout boolean
isInMutator boolean
isInsertionMarker_ protected boolean „True“, wenn dieser Block eine Einfügungsmarkierung ist.
loadExtraState? (p1: alle) => voidm (Optional) Eine optionale Serialisierungsmethode, mit der definiert wird, wie der zusätzliche Status des Blocks (z. B. der Mutationsstatus) aus einem JSON-kompatiblen Zustand deserialisiert wird. Dies muss mit der Definition von saveExtraState gekoppelt werden.
mutationToDom? (...p1: alle[]) => Unterelement (Optional) Eine optionale Serialisierungsmethode, mit der definiert wird, wie der Mutationsstatus in XML serialisiert wird. Dies muss mit der Definition von domToMutation gekoppelt werden.
nextConnection Verbindung | null
bei Änderung? ((p1: Zusammenfassung) => void) | null (Optional) Eine optionale Callback-Methode, die verwendet wird, wenn sich der übergeordnete Arbeitsbereich des Blocks ändert. Diese wird normalerweise nur vom Konstruktor, der Blocktyp-Initialisiererfunktion oder einer Erweiterungsinitialisierungsfunktion aufgerufen.
outputConnection Verbindung | null
outputShape_ protected Zahl | null
parentBlock_ protected dies | null
previousConnection Verbindung | null
gerendert readonly boolean Ist dies ein BlockSVG?
RTL boolean
saveExtraState? (doFullSerialization?: boolean) => Beliebige(r,s) (Optional) Eine optionale Serialisierungsmethode, mit der definiert wird, wie der zusätzliche Status des Blocks (z. B. der Mutationsstatus) in einen JSON-kompatiblen Zustand serialisiert wird. Dies muss mit der Definition von loadExtraState gekoppelt werden.
styleName_ protected String Name des Blockstils.
suppressPrefixSuffix boolean | null Eine optionale Eigenschaft, um das Hinzufügen von STATEMENT_PREFIX und STATEMENT_SUFFIX zu generierten Code zu unterdrücken.
Kurzinfo Tooltip.TipInfo
type String
Workspace Workspace

Methoden

Methode Modifikatoren Beschreibung
addIcon(icon) Fügt dem Block das angegebene Symbol hinzu.
allInputsFilled(opt_shadowBlocksAreFilled) Prüft rekursiv, ob alle Anweisungs- und Werteingaben mit Blöcken gefüllt sind. Prüft außerdem alle folgenden Anweisungsblöcke in diesem Stack.
appendDummyInput(name) Hängt eine Dummy-Eingabezeile an.
appendEndRowInput(name) Hängt eine Eingabe an, die die Zeile beendet.
appendInput(input)

Hängt die angegebene Eingabezeile an.

Damit können benutzerdefinierte Eingaben an den Block angehängt werden.

appendStatementInput(name) Hängt eine Anweisungseingabezeile an.
appendValueInput(name) Fügt eine Werteingabezeile an.
bumpNeighbours() Stoßen Sie nicht verbundene Blöcke an, die nicht koordiniert sind. Zwei Blöcke, die nicht wirklich miteinander verbunden sind, dürfen sich nicht zufällig auf dem Bildschirm befinden.
dispose(healStack) Entsorgen Sie diesen Block.
disposeInternal() protected Beseitigt diesen Block, ohne die für den oberen Block erforderlichen Aktionen auszuführen. Beispiel: löst keine Ereignisse aus, trennt die Blockierung usw.
doInit_() protected Ruft die Funktion init() auf und verarbeitet die zugehörige Ereignisauslösung usw.
getChildren(ordered) Suchen Sie alle Blöcke, die direkt in diesem verschachtelt sind. Umfasst Eingaben für Werte und Anweisungen sowie alle folgenden Anweisungen. Schließt alle Verbindungen auf einem Ausgabetab oder in einer vorhergehenden Anweisung aus. Blöcke können optional nach Position sortiert werden. von oben nach unten.
getColour() Ermitteln Sie die Farbe eines Blocks.
getCommentText() Gibt den Kommentar zu diesem Block zurück (oder null, wenn kein Kommentar vorhanden ist).
getDescendants(ordered) Suchen Sie alle Blöcke, die direkt oder indirekt in diesem Block verschachtelt sind. Nimmt diesen Block in die Liste auf. Umfasst Eingaben für Werte und Anweisungen sowie alle folgenden Anweisungen. Schließt alle Verbindungen auf einem Ausgabetab oder vorhergehende Anweisungen aus. Blöcke können optional nach Position sortiert werden. von oben nach unten.
getDisabledReasons() Rufen Sie gegebenenfalls eine Reihe von Gründen ab, warum die Blockierung derzeit deaktiviert ist. Wenn der Block aktiviert ist, ist dieser Satz leer.
getField(name) Gibt das benannte Feld aus einem Block zurück.
getFieldValue(name) Gibt den sprachneutralen Wert des angegebenen Felds zurück.
getHue() Rufen Sie den HSV-Farbtonwert eines Blocks ab. Null, wenn der Farbton nicht festgelegt ist.
getIcon(type)
getIcons()
getInheritedDisabled() Rufen Sie ab, ob die Blockierung aufgrund der Eltern deaktiviert wurde oder nicht. Die eigene deaktivierte Property des Blocks wird nicht berücksichtigt.
getInput(name) Ruft das benannte Eingabeobjekt ab.
getInputsInline() Ermitteln Sie, ob die Werteingaben horizontal oder vertikal angeordnet sind.
getInputTargetBlock(name) Ruft den Block ab, der an die benannte Eingabe angehängt ist.
getInputWithBlock(block) Gibt die Eingabe zurück, die eine Verbindung zum angegebenen Block herstellt.
getNextBlock() Gibt den nächsten Anweisungsblock zurück, der direkt mit diesem Block verbunden ist.
getOutputShape() Rufen Sie die Ausgabeform des Blocks ab.
getParent() Gibt den übergeordneten Block oder null zurück, wenn sich dieser Block auf der obersten Ebene befindet. Der übergeordnete Block ist entweder der Block, der mit der vorherigen Verbindung verbunden ist (für einen Anweisungsblock) oder der mit der Ausgabeverbindung verbundene Block (für einen Wertblock).
getPreviousBlock() Gibt den Block zurück, der mit der vorherigen Verbindung verbunden ist.
getRelativeToSurfaceXY() Gibt die Koordinaten der linken oberen Ecke dieses Blocks relativ zum Ursprung der Zeichenfläche (0,0) in Arbeitsbereichseinheiten zurück.
getRootBlock() Gibt den obersten Block in der Struktur dieses Blocks zurück. Dies wird zurückgegeben, wenn sich dieser Block auf der obersten Ebene befindet.
getStyleName() Rufen Sie den Namen des Blockstils ab.
getSurroundParent() Gibt den übergeordneten Block zurück, der den aktuellen Block umgibt, oder null, wenn dieser Block keinen umgebenden Block hat. Ein übergeordneter Block kann einfach die vorherige Anweisung sein, während der umgebende Block eine if-Anweisung, während eine Schleife usw. ist.
getTooltip() Gibt den Text der Kurzinfo für diesen Block zurück.
getVars() Gibt alle Variablen zurück, auf die in diesem Block verwiesen wird.
hasDisabledReason(reason) Ruft ab, ob die Blockierung derzeit aus dem angegebenen Grund deaktiviert ist.
hasIcon(type)
initModel() Rufen Sie initModel für alle Felder im Block auf. Kann mehrmals aufgerufen werden. Nach dem Erstellen eines Blocks und vor der ersten Interaktion mit diesem muss entweder initModel oder initSvg aufgerufen werden. Interaktionen umfassen UI-Aktionen (z.B. Klicken und Ziehen) und das Auslösen von Ereignissen (z.B. erstellen, löschen und ändern).
isCollapsed() Rufen Sie ab, ob der Block minimiert ist.
isDeletable() Ruft ab, ob dieser Block löschbar ist oder nicht.
isDisposed() Gibt zurück, ob dieser Block entsorgt / gelöscht wurde.
isDuplicatable() Rufen Sie ab, ob der Block dupliziert werden kann. Wenn Sie diesen Block und die untergeordneten Elemente duplizieren, wird dieser Block die Kapazität des Arbeitsbereichs überschreiten. Dieser Block kann nicht dupliziert werden. Wenn Sie diesen Block duplizieren und Nachfolgerelemente einen beliebigen Typ über ihre maxInstances setzen, kann dieser Block nicht dupliziert werden.
isEnabled() Rufen Sie ab, ob diese Blockierung aktiviert ist oder nicht. Eine Blockierung gilt als aktiviert, wenn es keine Gründe für eine Deaktivierung gibt. Eine Blockierung kann auch dann aus anderen Gründen deaktiviert sein, wenn der Nutzer versucht, sie manuell zu aktivieren, z. B. wenn sich die Blockierung an einem ungültigen Ort befindet.
isInsertionMarker() Rufen Sie ab, ob es sich bei diesem Block um eine Einfügungsmarkierung handelt oder nicht.
isOwnDeletable() Gibt zurück, ob die eigene löschbare Eigenschaft dieses Blocks wahr oder falsch ist.
isOwnEditable() Gibt an, ob die eigene bearbeitbare Eigenschaft dieses Blocks wahr oder falsch ist.
isShadow() Rufen Sie ab, ob dieser Block ein Schattenblock ist oder nicht.
jsonInit(json) Initialisieren Sie diesen Block mit einer plattformübergreifenden, internationalisierungsfreundlichen JSON-Beschreibung.
mixin(mixinObj, opt_disableCheck) Fügen Sie Schlüssel/Wert-Paare aus mixinObj zu diesem Blockobjekt hinzu. Standardmäßig überprüft diese Methode, dass die Schlüssel in mixinObj keine vorhandenen Werte im Block überschreiben, einschließlich Prototypwerten. Dies bietet eine gewisse Absicherung gegen Mixin-/Erweiterungs-Inkompatibilitäten mit zukünftigen Blockierfunktionen. Diese Prüfung kann deaktiviert werden, indem „true“ als zweites Argument übergeben wird.
moveBy(dx, dy, reason) Verschieben Sie einen Block um einen relativen Versatz.
moveInputBefore(name, refName) Benannte Eingabe an eine andere Position innerhalb dieses Blocks verschieben.
moveNumberedInputBefore(inputIndex, refIndex) Nummerierte Eingabe an eine andere Stelle im Block verschieben.
removeIcon(type) Entfernt das Symbol, dessen getType dem angegebenen Typ iconType entspricht, aus dem Block.
removeInput(name, opt_quiet) Eingabe aus diesem Block entfernen.
renameVarById(oldId, newId) Benachrichtigung, dass eine Variable umbenannt wird. Wenn die ID mit einer der Variablen dieses Blocks übereinstimmt, benennen Sie diese um.
setCollapsed(collapsed) Legen Sie fest, ob der Block minimiert werden soll.
setColour(colour) Farbe eines Blocks ändern
setCommentText(text) Kommentartext für diesen Block festlegen.
setDeletable(deletable) Legen Sie fest, ob dieser Block löschbar ist oder nicht.
setDisabledReason(disabled, reason) Geben Sie einen Grund für die Deaktivierung der Blockierung an oder entfernen Sie einen Grund. Wenn eine Blockierung einen Grund für die Deaktivierung hat, wird die Blockierung selbst als deaktiviert betrachtet. Eine Blockierung kann aus mehreren unterschiedlichen Gründen gleichzeitig deaktiviert werden, z. B. wenn der Nutzer sie manuell deaktiviert oder die Blockierung ungültig ist.
setEditable(editable) Legen Sie fest, ob dieser Block bearbeitbar ist oder nicht.
setEnabled(enabled)
setFieldValue(newValue, name) Legt den Wert des angegebenen Felds für diesen Block fest.
setHelpUrl(url) Legt die URL der Hilfeseite für diesen Block fest.
setInputsInline(newBoolean) Hier legen Sie fest, ob die Werteingaben horizontal oder vertikal angeordnet werden.
setMovable(movable) Legen Sie fest, ob dieser Block beweglich ist oder nicht.
setMutator(_mutator) Weisen Sie dieser Blockierung ein Dialogfeld zum Mutator zu.
setNextStatement(newBoolean, opt_check) Legen Sie fest, ob ein weiterer Block am unteren Ende dieses Blocks verkettet werden kann.
setOnChange(onchangeFn) Legt eine Callback-Funktion fest, die immer dann verwendet werden soll, wenn sich der übergeordnete Arbeitsbereich des Blocks ändert. Dadurch werden alle vorherigen onchange-Handler ersetzt. Diese wird normalerweise nur vom Konstruktor, der Blocktyp-Initialisiererfunktion oder einer Erweiterungsinitialisierungsfunktion aufgerufen.
setOutput(newBoolean, opt_check) Legt fest, ob dieser Block einen Wert zurückgibt.
setOutputShape(outputShape) Legen Sie die Ausgabeform des Blocks fest.
setPreviousStatement(newBoolean, opt_check) Legen Sie fest, ob dieser Block am Ende eines anderen Blocks verkettet werden kann.
setStyle(blockStyleName) Legen Sie die Stil- und Farbwerte eines Blocks fest.
setTooltip(newTip) Legt die Kurzinfo für diesen Block fest.
setWarningText(_text, _opt_id) Legen Sie den Warntext für diesen Block fest.
toDevString()

Diese Methode gibt einen String zurück, der diesen Block in Bezug auf Entwickler beschreibt (Typ und ID; nur auf Englisch verfügbar).

Vorgesehen zur Verwendung in Konsolenprotokollen und -fehlern. Wenn Sie einen String in der Muttersprache des Nutzers benötigen (einschließlich Blocktext, Feldwerte und untergeordneten Blöcken), verwenden Sie [toString()].

toString(opt_maxLength, opt_emptyToken) Erstellt eine menschenlesbare Textdarstellung dieses Blocks und aller untergeordneten Elemente.
unplug(opt_healStack) Entfernen Sie diesen Block vom übergeordneten Block. Wenn es sich bei diesem Block um eine Anweisung handelt, können Sie den darunter liegenden Block mit dem Block oben verbinden.