blockly > Block

Blockklasse

Kurs für einen Block. Wird normalerweise nicht direkt aufgerufen. Stattdessen wird workspace.newBlock() bevorzugt.

Unterschrift:

export declare class Block 

Konstruktoren

Konstruktor	Modifikatoren	Beschreibung
(constructor)(workspace, prototypeName, opt_id)		Erstellt eine neue Instanz der Klasse Block.

Attribute

Attribut	Modifikatoren	Typ	Beschreibung
childBlocks_	protected	dieses[]
collapsed_	protected	boolean
COLLAPSED_FIELD_NAME	static readonly	String	Die sprachneutrale ID, die dem minimierten Feld zugewiesen ist.
COLLAPSED_INPUT_NAME	static readonly	String	Die sprachneutrale ID, die der minimierten Eingabe zugewiesen ist.
colour_	protected	String	Farbe des Blocks im Format #RRGGBB.
compose?		(rootBlock: Block) => void	Optional: Eine optionale Methode, mit der der Block basierend auf dem Inhalt des Dialogfelds für den Mutator neu konfiguriert wird.
contextMenu		boolean
Daten		string | null	Optionale Textdaten, die zwischen Blöcken und XML hin- und hergesendet werden. Hat keine Wirkung. Kann von Drittanbietern für Metainformationen verwendet werden.
zerlegen?		(workspace: Workspace) => Blockieren	Optional: Eine optionale Funktion, die das Flyout des Modifiers mit Blöcken füllt, die die Konfiguration dieses Blocks darstellen.
zerstören?		() => void	Optional: Eine optionale Methode, die bei der Entsorgung aufgerufen wird.
disposing	protected	boolean	Wird der aktuelle Block gerade gelöscht?
domToMutation?		(p1: Element) => void	Optional: Eine optionale Deserialisierungsmethode, mit der festgelegt wird, wie der Mutationsstatus aus XML deserialisiert wird. Dies muss mit der Definition von mutationToDom kombiniert werden.
getDeveloperVariables?		() => string[]	Optional: Eine optionale Methode zum Deklarieren von Entwicklervariablen, die von Generatoren verwendet werden. Entwicklervariablen werden Nutzern nie angezeigt, sondern im generierten Code als globale Variablen deklariert.
hat?		String	Optional: Name der Hutart.
helpUrl		string | (() => string) | null	String für die Blockierungshilfe 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[]
inputsInline?		boolean	(Optional)
inputsInlineDefault?		boolean	(Optional)
isInFlyout		boolean
isInMutator		boolean
isInsertionMarker_	protected	boolean	„Wahr“, wenn dieser Block eine Einfügemarke ist.
loadExtraState?		(p1: any) => void	Optional: Eine optionale Serializationsmethode, mit der festgelegt wird, wie der zusätzliche Status des Blocks (z. B. der Mutationsstatus) aus einem JSON-kompatiblen Objekt deserialisiert wird. Dies muss mit der Definition von saveExtraState kombiniert werden.
mutationToDom?		(...p1: any[]) => Element	Optional: Eine optionale Serializationsmethode, mit der festgelegt wird, wie der Mutationsstatus in XML serialisiert wird. Dies muss mit der Definition von domToMutation kombiniert werden.
nextConnection		Verbindung | null
onchange?		((p1: Abstract) => void) | null	Optional: Eine optionale Callback-Methode, die verwendet wird, wenn sich der übergeordnete Arbeitsbereich des Blocks ändert. Sie wird normalerweise nur vom Konstruktor, der Initialisierungsfunktion für den Blocktyp oder einer Initialisierungsfunktion für die Erweiterung aufgerufen.
outputConnection		Verbindung | null
outputShape_	protected	number | null
parentBlock_	protected	this | null
previousConnection		Verbindung | null
rendern	readonly	boolean	Ist dieser Block ein BlockSVG?
RTL		boolean
saveExtraState?		(doFullSerialization?: boolean) => any	Optional: Eine optionale Serializationsmethode, mit der festgelegt wird, wie der zusätzliche Status des Blocks (z. B. der Mutationsstatus) in ein JSON-kompatibles Format serialisiert wird. Dies muss mit der Definition von loadExtraState kombiniert werden.
styleName_	protected	String	Name des Blockstils.
suppressPrefixSuffix		boolean | null	Eine optionale Property, mit der das Hinzufügen von STATEMENT_PREFIX und STATEMENT_SUFFIX zum generierten Code unterdrückt wird.
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 Wertinputs mit Blöcken ausgefüllt sind. Prüft auch alle nachfolgenden Anweisungsblöcken in diesem Stack.
appendDummyInput(name)		Fängt eine Dummy-Eingabezeile an.
appendEndRowInput(name)		Fügt 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 Zeile für die Eingabe des Kontoauszugs an.
appendValueInput(name)		Hängt eine Zeile für die Eingabe von Werten an.
bumpNeighbours()		Verschieben Sie nicht verbundene Blöcke aus der Flucht. Zwei Blöcke, die nicht miteinander verbunden sind, sollten sich nicht zufällig auf dem Bildschirm überschneiden.
dispose(healStack)		Entsorgen Sie diesen Block.
disposeInternal()	protected	Dieser Block wird entfernt, ohne dass die vom übergeordneten Block geforderten Aktionen ausgeführt werden. z. B. löst keine Ereignisse aus, löst keine Ereignisse aus, löst keine Ereignisse aus
doInit_()	protected	Ruft die Funktion „init()“ auf und verarbeitet das zugehörige Ereignis.
getChildren(ordered)		Alle Blöcke finden, die direkt in diesem Block verschachtelt sind. Umfasst Wert- und Anweisungseingaben sowie alle nachfolgenden Anweisungen. Schließt alle Verbindungen auf einem Ausgabetab oder alle vorangehenden Anweisungen aus. Blöcke können optional nach Position sortiert werden, von oben nach unten.
getColour()		Die Farbe eines Blocks abrufen
getCommentText()		Gibt den Kommentar zu diesem Block zurück (oder „null“, wenn kein Kommentar vorhanden ist).
getDescendants(ordered)		Alle Blöcke finden, die direkt oder indirekt in diesem Block verschachtelt sind Dieser Block wird in die Liste aufgenommen. Umfasst Werte und Anweisungseingaben sowie alle nachfolgenden Anweisungen. Schließt alle Verbindungen auf einem Ausgabetab oder alle vorangehenden Anweisungen aus. Blöcke können optional nach Position sortiert werden, von oben nach unten.
getDisabledReasons()		Gründe dafür, warum die Blockierung derzeit deaktiviert ist, falls zutreffend Wenn der Block aktiviert ist, ist diese Gruppe leer.
getField(name)		Gibt das benannte Feld aus einem Block zurück.
getFields()		Gibt einen Generator zurück, der alle Felder im Block bereitstellt. Ein Generator, mit dem die Felder im Block iteriert werden können.
getFieldValue(name)		Gibt den sprachunabhängigen Wert des angegebenen Felds zurück.
getHue()		Ruft den HSV-Farbtonwert eines Blocks ab. Null, wenn der Farbton nicht festgelegt ist.
getIcon(type)
getIcons()
getInheritedDisabled()		Gibt an, ob die Blockierung aufgrund von Eltern deaktiviert ist oder nicht. Die eigene deaktivierte Property des Blocks wird nicht berücksichtigt.
getInput(name)		Das benannte Eingabeobjekt wird abgerufen.
getInputsInline()		Gibt an, ob Eingaben für Werte 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 mit dem angegebenen Block verbunden ist.
getNextBlock()		Gibt den nächsten Anweisungsblock zurück, der direkt mit diesem Block verbunden ist.
getOutputShape()		Ausgabeform des Blocks abrufen
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 linken oberen Ecke dieses Blocks relativ zum Ursprung (0,0) der Zeichenfläche in Arbeitsbereichseinheiten zurück.
getRootBlock()		Gibt den obersten Block im Baum dieses Blocks zurück. Wenn sich dieser Block auf der obersten Ebene befindet, wird er selbst zurückgegeben.
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 übergeordneten Block hat. Ein übergeordneter Block kann einfach die vorherige Anweisung sein, während der umgebende Block eine If-Anweisung oder eine While-Schleife 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)		Gibt an, 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. Entweder initModel oder initSvg muss nach dem Erstellen eines Blocks und vor der ersten Interaktion damit aufgerufen werden. Zu den Interaktionen gehören UI-Aktionen (z.B. Klicken und Ziehen) und das Auslösen von Ereignissen (z.B. Erstellen, Löschen und Ändern).
isCollapsed()		Gibt an, ob der Block minimiert ist oder nicht.
isDeletable()		Gibt an, ob dieser Block gelöscht werden kann oder nicht.
isDisposed()		Gibt zurück, ob dieser Block entsorgt oder gelöscht wurde.
isDuplicatable()		Gibt an, ob der Block dupliziert werden kann oder nicht. Wenn durch das Duplizieren dieses Blocks und seiner untergeordneten Blöcke die Kapazität des Arbeitsbereichs überschritten wird, kann der Block nicht dupliziert werden. Wenn durch das Duplizieren dieses Blocks und seiner Nachkommen ein Typ über die maximale Anzahl von Instanzen hinausgeht, kann dieser Block nicht dupliziert werden.
isEnabled()		Gibt an, ob diese Blockierung aktiviert ist oder nicht. Ein Block gilt als aktiviert, wenn es keinen Grund gibt, ihn zu deaktivieren. Ein Block kann aus anderen Gründen deaktiviert bleiben, auch wenn der Nutzer versucht, ihn manuell zu aktivieren, z. B. wenn er sich an einem ungültigen Ort befindet.
isInsertionMarker()		Gibt an, ob dieser Block ein Block mit Einfügemarkierung ist oder nicht.
isOwnDeletable()		Gibt zurück, ob die Property „deletable“ dieses Blocks wahr oder falsch ist.
isOwnEditable()		Gibt an, ob die bearbeitbare Property dieses Blocks „wahr“ oder „falsch“ ist.
isShadow()		Gibt an, ob es sich bei diesem Block um einen Schattenblock handelt.
jsonInit(json)		Initialisieren Sie diesen Block mit einer plattformübergreifenden, internationalisierungsfreundlichen JSON-Beschreibung.
mixin(mixinObj, opt_disableCheck)		Fügen Sie diesem Blockobjekt Schlüssel/Werte aus mixinObj hinzu. Standardmäßig wird mit dieser Methode geprüft, ob die Schlüssel in mixinObj vorhandene Werte im Block überschreiben, einschließlich Prototypwerte. So können Sie sich vor Inkompatibilitäten von Mixins / Erweiterungen mit zukünftigen Blockfunktionen schützen. Diese Prüfung kann deaktiviert werden, indem als zweites Argument „wahr“ übergeben wird.
moveBy(dx, dy, reason)		Einen Block um einen relativen Versatz verschieben.
moveInputBefore(name, refName)		Verschieben Sie eine benannte Eingabe an eine andere Stelle in diesem Block.
moveNumberedInputBefore(inputIndex, refIndex)		Eine nummerierte Eingabe an eine andere Stelle in diesem Block verschieben.
removeIcon(type)		Entfernt das Symbol, dessen getType mit dem angegebenen Typ „iconType“ übereinstimmt, aus dem Block.
removeInput(name, opt_quiet)		Entfernen Sie 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 sie um.
setCollapsed(collapsed)		Legen Sie fest, ob der Block minimiert ist oder nicht.
setColour(colour)		Farbe eines Blocks ändern
setCommentText(text)		Legen Sie den Kommentartext für diesen Block fest.
setDeletable(deletable)		Legen Sie fest, ob dieser Block gelöscht werden kann oder nicht.
setDisabledReason(disabled, reason)		Fügen Sie einen Grund hinzu, warum die Blockierung möglicherweise deaktiviert wurde, oder entfernen Sie einen solchen Grund. Wenn ein Block aus irgendeinem Grund deaktiviert werden sollte, wird er als deaktiviert betrachtet. Eine Blockierung kann aus mehreren unabhängigen 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.
setFieldValue(newValue, name)		Legt den Wert des angegebenen Felds für diesen Block fest.
setHelpUrl(url)		Legen Sie die URL der Hilfeseite für diesen Block fest.
setInputsInline(newBoolean)		Legen Sie fest, ob Eingaben für Werte horizontal oder vertikal angeordnet werden.
setMovable(movable)		Legen Sie fest, ob dieser Block verschiebbar ist oder nicht.
setMutator(_mutator)		Geben Sie diesem Block ein Mutatator-Dialogfeld.
setNextStatement(newBoolean, opt_check)		Legen Sie fest, ob ein anderer Block unten an diesen Block angehängt werden kann.
setOnChange(onchangeFn)		Hiermit wird eine Rückruffunktion festgelegt, die verwendet wird, wenn sich der übergeordnete Arbeitsbereich des Blocks ändert. Vorherige onchange-Handler werden ersetzt. Sie wird normalerweise nur vom Konstruktor, der Initialisierungsfunktion für den Blocktyp oder der Initialisierungsfunktion für die Erweiterung aufgerufen.
setOutput(newBoolean, opt_check)		Legen Sie 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 an den unteren Teil eines anderen Blocks angehängt werden kann.
setStyle(blockStyleName)		Legen Sie den Stil und die Farbwerte eines Blocks fest.
setTooltip(newTip)		Legt die Kurzinfo für diesen Block fest.
setWarningText(_text, _opt_id)		Legen Sie den Warnungstext für diesen Block fest.
toDevString()		Diese Methode gibt einen String zurück, der diesen Block in Entwicklerbegriffen beschreibt (Typname und ID; nur auf Englisch). Soll nur in Konsolenprotokollen und Fehlern verwendet werden. Wenn Sie einen String benötigen, der die Muttersprache des Nutzers verwendet (einschließlich Blocktext, Feldwerte und untergeordnete Blöcke), verwenden Sie toString().
toString(opt_maxLength, opt_emptyToken)		Erstellen Sie eine für Menschen lesbare Textdarstellung dieses Blocks und aller untergeordneten Elemente.
unplug(opt_healStack)		Trennen Sie diesen Block von seinem übergeordneten Block. Wenn dieser Block eine Anweisung ist, können Sie den Block darunter optional wieder mit dem Block darüber verbinden.