blockly > Blockieren

Kurs blockieren

Klasse für einen Block. Normalerweise nicht direkt aufgerufen, wird workspace.newBlock() bevorzugt.

Unterschrift:

export declare class Block implements IASTNodeLocation, IDeletable 

Implementierungen: IASTNodeLocation, IDeletable

Konstruktoren

Konstruktor Modifikatoren Beschreibung
(Konstruktor)(workspace, prototypName, opt_id) Konstruiert eine neue Instanz der Klasse Block

Attribute

Property Modifikatoren Typ Beschreibung
childBlocks_ protected dieses[]
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 der minimierten Eingabe.
colour_ protected String Farbe des Blocks im Format "#RRGGBB"
compose? (p1: Blockieren) => ungültig (Optional) Eine optionale Funktion, die den Block basierend auf den Inhalten des Mutator-Dialogfelds neu konfiguriert.
contextMenu boolean
Daten String | null Optionale Textdaten, die zwischen Blöcken und XML ausgetauscht werden Hat keine Wirkung. Kann von Dritten für Meta-Informationen verwendet werden.
verzerren? (p1: Arbeitsbereich) => Blockieren (Optional) Eine optionale Funktion, mit der die Komponenten dieses Blocks in das Dialogfeld des Mutators eingetragen werden.
destroy? () => void (Optional) Eine optionale Methode, die bei der Vernichtung aufgerufen wird.
domToMutation? (p1: Element) => void (Optional) Eine optionale Deserialisierungsmethode, um zu definieren, wie der Mutationsstatus aus XML deserialisiert wird. Dies muss mit der Definition von mutationToDom gekoppelt werden.
EntwicklerVariables abrufen? () => string[] (Optional) Eine optionale Property zum Deklarieren von Entwicklervariablen. Gibt eine Liste von Variablennamen zur Verwendung durch Generatoren zurück. Entwicklervariablen werden dem Nutzer nie angezeigt, jedoch im generierten Code als globale Variablen deklariert.
Hut? String (Optional) Die Bezeichnung des Huttyps.
helpUrl string | Function | null String für die Blockhilfe oder Funktion, die eine URL zurückgibt. Null für keine Hilfe.
Symbole IIcon[]
id String
init? () => void (Optional) Eine optionale Methode, die während der Initialisierung aufgerufen wird.
inputList Eingabe[]
inputInline? boolean (Optional)
inputsInlineDefault? boolean (Optional)
isInFlyout boolean
isInMutator boolean
isInsertionMarker_ protected boolean Dieser Wert ist "True", wenn dieser Block eine Einfügungsmarkierung ist.
loadExtraState? (p1: alle) => nichtig (Optional) Eine optionale Serialisierungsmethode, um zu definieren, wie der zusätzliche Status des Blocks (z. B. Mutationsstatus) von einem JSON-kompatiblen Element deserialisiert wird. Dies muss mit der Definition von saveExtraState gekoppelt werden.
mutationToDom? (...p1: any[]) => Element (Optional) Eine optionale Serialisierungsmethode, um zu definieren, wie der Mutationsstatus in XML serialisiert wird Dies muss mit der Definition von domToMutation gekoppelt sein.
nextConnection Verbindung | null
onchange? ((p1: Abstract) => void) | null Optional: Eine optionale Callback-Methode, die verwendet wird, wenn sich der übergeordnete Arbeitsbereich des Blocks ändert. Diese wird normalerweise nur vom Konstruktor, von der Funktion zum Initialisieren des Blocktyps oder von einer Funktion zum Initialisieren von Erweiterungen aufgerufen.
outputConnection Verbindung | null
outputShape_ protected Zahl | null
parentBlock_ protected dies | null
previousConnection Verbindung | null
gerendert boolean | null
RTL boolean
saveExtraState? (doFullSerialization?: boolean) => beliebig (Optional) Eine optionale Serialisierungsmethode, um zu definieren, wie der zusätzliche Status des Blocks (z. B. Mutationsstatus) in einen JSON-kompatiblen Wert serialisiert werden soll. Dies muss mit der Definition von loadExtraState gekoppelt werden.
styleName_ protected String Name des Blockstils.
suppressPrefixSuffix boolean | null Eine optionale Eigenschaft, mit der das Hinzufügen von STATEMENT_PREFIX und STATEMENT_SUFFIX zu generiertem Code unterdrückt wird.
Kurzinfo Tooltip.TipInfo
Typ String
Arbeitsbereich Workspace

Methoden

Methode Modifikatoren Beschreibung
addIcon(icon) Fügt das angegebene Symbol zum Block hinzu.
allInputsFilled(opt_shadowBlocksAreFilled) Prüft rekursiv, ob alle Eingaben für Anweisungen und Werte mit Blöcken gefüllt sind. Prüft auch alle folgenden Anweisungsblöcke in diesem Stapel.
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.

Ermöglicht das Anhängen benutzerdefinierter Eingaben an den Block.

appendStatementInput(name) Hängt eine Anweisungseingabezeile an.
appendValueInput(name) Hängt eine Werteingabezeile an.
bumpNeighbours() Bringen Sie nicht verbundene Blöcke in Ausrichtung. Zwei Blöcke, die eigentlich nicht miteinander verbunden sind, sollten nicht zufällig auf dem Bildschirm übereinander angeordnet sein.
dispose(healStack) Diesen Block entsorgen.
disposeInternal() protected Beseitigt diesen Block, ohne die für den oberen Block erforderlichen Schritte zu tun. Es werden z.B. keine Ereignisse ausgelöst oder der Block vom Stromnetz getrennt.
doInit_() protected Ruft die Funktion „init()“ auf, verarbeitet die Auslösung des zugehörigen Ereignisses usw.
getChildren(ordered) Suchen Sie alle Blöcke, die direkt in diesem Blöcke verschachtelt sind. Enthält Werte- und Anweisungseingaben sowie folgende Anweisungen. Schließt alle Verbindungen auf einem Ausgabetab oder einer vorhergehenden Anweisung aus. Blöcke werden optional nach Position (von oben nach unten) sortiert.
getColour() Farbe eines Blocks abrufen
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 Blöcke verschachtelt sind. Nimmt diesen Block in die Liste auf. Enthält Werte- und Anweisungseingaben sowie folgende Anweisungen. Schließt alle Verbindungen auf einem Ausgabetab oder vorhergehenden Anweisungen aus. Blöcke werden optional nach Position (von oben nach unten) sortiert.
getField(name) Gibt das benannte Feld eines Blocks zurück
getFieldValue(name) Gibt den sprachneutralen Wert des angegebenen Felds zurück.
getHue(). Ruft den HSV-Farbton eines Blocks ab. Null, wenn der Farbton nicht festgelegt ist.
getIcon(type)
getIcons()
getInheritedDisabled() Ermitteln Sie, ob die Blockierung aufgrund von übergeordneten Elementen deaktiviert wurde. Die eigene deaktivierte Property der Blockierung wird nicht berücksichtigt.
getInput(name) Ruft das benannte Eingabeobjekt ab.
getInputsInline() Ruft ab, ob Werteingaben horizontal oder vertikal angeordnet sind.
getInputTargetBlock(name) Ruft den Block ab, der mit der benannten Eingabe verknüpft 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() Ruft die Ausgabeform des Blocks ab.
getParent() Gibt den übergeordneten Block zurück oder null, wenn sich dieser Block auf der obersten Ebene befindet. Der übergeordnete Block ist entweder der Block, der mit der vorherigen Verbindung verbunden ist (bei einem Anweisungsblock), oder der Block, der mit der Ausgabeverbindung verbunden ist (bei einem Wertblock).
getPreviousBlock() Gibt den Block zurück, der mit der vorherigen Verbindung verbunden ist.
getRelativeToSurfaceXY(). Gibt die Koordinaten der oberen linken Ecke dieses Blocks relativ zum Ursprung der Zeichnungsoberfläche (0,0) in Arbeitsbereichseinheiten zurück.
getRootBlock() Geben Sie den obersten Block in der Baumstruktur dieses Blocks zurück. Dieses Element wird selbst zurückgegeben, wenn sich dieser Block auf der obersten Ebene befindet.
getStyleName() Rufen Sie den Namen des Blockstils ab.
getSurroundParent() Return the parent block that surrounds the current block, or null if this block has no surrounding block. Ein übergeordneter Block kann einfach die vorherige Anweisung sein, während der umgebende Block eine if-Anweisung, eine während-Schleife usw. ist.
getTooltip() Gibt die Kurzinfo für diesen Block zurück
getVars() Gibt alle Variablen zurück, auf die in diesem Block verwiesen wird.
hasIcon(type)
initModel() Rufen Sie initModel für alle Felder des Blocks auf. Kann mehrmals aufgerufen werden. InitModel oder initSvg muss nach dem Erstellen eines Blocks und vor der ersten Interaktion mit diesem aufgerufen werden. Interaktionen sind UI-Aktionen (z.B. Klicken und Ziehen) und das Auslösen von Ereignissen (z.B. Erstellen, Löschen und Ändern).
isCollapsed() Ruft ab, ob der Block minimiert ist oder nicht.
isDeletable() Gibt an, ob dieser Block löschbar ist oder nicht.
isDisposed() Gibt zurück, ob dieser Block verworfen / gelöscht wurde.
isDuplicatable() Ruft ab, ob der Block duplizierbar ist oder nicht. Durch das Duplizieren dieses Blocks und der Nachfolger wird dieser Block zur Überschreitung der Kapazität des Arbeitsbereichs. Dieser Block kann nicht dupliziert werden. Wenn durch das Duplizieren dieses Blocks und von Nachfolgertypen ein beliebiger Typ über ihre maxInstances hinausgeht, kann dieser Block nicht dupliziert werden.
isEnabled() Ermitteln Sie, ob diese Blockierung aktiviert ist oder nicht.
isInsertionMarker() Ruft ab, ob dieser Block ein Einfügungsmarkierungsblock ist oder nicht.
isOwnDeletable() Gibt an, ob die eigene löschbare Eigenschaft dieses Blocks „true“ oder „false“ ist.
isOwnEditable() Gibt an, ob die bearbeitbare Eigenschaft dieser Blockierung wahr oder falsch ist.
isShadow() Ermitteln Sie, ob dieser Block ein Schattenblock ist.
jsonInit(json) Initialisieren Sie diesen Block mit einer plattformübergreifenden, internationalisierungsfreundlichen JSON-Beschreibung.
mixin(mixinObj, opt_disableCheck) Fügen Sie diesem Blockobjekt Schlüssel/Wert-Paare aus mixinObj hinzu. Standardmäßig wird mit dieser Methode geprüft, ob die Schlüssel in mixinObj vorhandene Werte im Block, einschließlich Prototyp-Werten, nicht überschreiben. Das bietet eine gewisse Absicherung gegen Inkompatibilitäten von Mixin-/Erweiterungen mit zukünftigen Blockfunktionen. Diese Prüfung kann deaktiviert werden, indem „true“ als zweites Argument übergeben wird.
moveBy(dx, dy, reason) Block wird um einen relativen Offset verschoben.
moveInputBefore(name, refName) Verschiebt einen benannten Eingang an eine andere Position in diesem Block.
moveNumberedInputBefore(inputIndex, refIndex) Verschiebt einen nummerierten Eingang an eine andere Position in diesem Block.
removeIcon(type) Entfernt das Symbol, dessen getType mit dem angegebenen type iconType übereinstimmt, aus dem Block.
removeInput(name, opt_quiet) Entfernt eine Eingabe aus diesem Block.
renameVarById(oldId, newId) Benachrichtigung, dass eine Variable umbenannt wird. Wenn die ID mit einer der Variablen dieses Blocks übereinstimmt, benennen Sie die ID 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 gelöscht werden kann oder nicht.
setEditable(editable) Legen Sie fest, ob diese Blockierung bearbeitet werden kann.
setEnabled(enabled) Legen Sie fest, ob die Blockierung aktiviert ist.
setFieldValue(newValue, name) Legt den Wert des angegebenen Felds für diesen Block fest.
setHelpUrl(url) Geben Sie die URL der Hilfeseite dieser Blockierung an.
setInputsInline(newBoolean) Legt fest, ob Werteingaben horizontal oder vertikal angeordnet werden.
setMovable(movable) Legen Sie fest, ob dieser Block verschiebbar ist.
setMutator(_mutator) Ein Mutator-Dialogfeld für diesen Block festlegen.
setNextStatement(newBoolean, opt_check) Legen Sie fest, ob ein weiterer Block an den unteren Rand dieses Blocks verkettet werden kann.
setOnChange(onchangeFn) Legt eine Callback-Funktion fest, die immer dann verwendet wird, wenn sich der übergeordnete Arbeitsbereich des Blocks ändert. Dabei werden alle vorherigen onchange-Handler ersetzt. Diese wird normalerweise nur vom Konstruktor, von der Funktion zum Initialisieren des Blocktyps oder von einer Funktion zum Initialisieren von Erweiterungen aufgerufen.
setOutput(newBoolean, opt_check) Legt fest, ob dieser Block einen Wert zurückgibt.
setOutputShape(outputShape) Legt die Ausgabeform des Blocks fest.
setPreviousStatement(newBoolean, opt_check) Legen Sie fest, ob dieser Block mit dem Ende eines anderen Blocks verkettet werden kann.
setStyle(blockStyleName) Legt 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 eine Zeichenfolge zurück, die diesen Block in den Entwicklerbegriffen beschreibt (Typname und -ID; nur Englisch).

Ist für die Verwendung in Konsolenprotokollen und -fehlern vorgesehen. Falls Sie einen String benötigen, in dem die Muttersprache des Nutzers verwendet wird (einschließlich Blocktext, Feldwerte und untergeordnete Blöcke), verwenden Sie [toString()].

toString(opt_maxLength, opt_emptyToken) Erstellen Sie eine menschenlesbare Textdarstellung dieses Blocks und aller untergeordneten Elemente.
unplug(opt_healStack) Entfernen Sie diesen Block aus dem oberen Block. Wenn dieser Block eine Anweisung ist, verbinden Sie optional den darunter liegenden Block mit dem Block oben.