blockly > Zablokuj

Zablokuj zajęcia

Zajęcia na 1 blokadę. Zwykle nie jest wywoływane bezpośrednio, jednak preferowana jest metoda workspace.newBlock().

Podpis:

export declare class Block implements IASTNodeLocation, IDeletable 

Implementacje: IASTNodeLocation, IDeletable

Zespoły

Zespół Modyfikatory Opis
(constructor)(workspace, prototypeName, opt_id) Konstruuje nową instancję klasy Block

Właściwości

Właściwość Modyfikatory Typ Opis
childBlocks_ protected to[]
collapsed_ protected boolean
COLLAPSED_FIELD_NAME

static

readonly

ciąg znaków Identyfikator neutralny dla języka nadany zwiniętemu polu.
COLLAPSED_INPUT_NAME

static

readonly

ciąg znaków Identyfikator neutralny dla języka nadany do zwiniętych danych wejściowych.
colour_ protected ciąg znaków Kolor bloku w formacie „#RRGGBB”.
compose? (p1: Zablokuj) => void (Opcjonalnie) Funkcja opcjonalna, która ponownie konfiguruje blok na podstawie zawartości okna mutatora.
contextMenu boolean
dane string | null Opcjonalne dane tekstowe przesyłane w obie strony między blokami i kodem XML. Brak efektu. Mogą być używane przez inne firmy do metainformacji.
rozłożyć? (p1: Obszar roboczy) => Zablokuj (Opcjonalnie) Opcjonalna funkcja, która wypełnia okno mutatora komponentami tego bloku.
destroy? () => void (Opcjonalnie) Opcjonalna metoda wywoływana podczas usuwania.
domToMutation? (p1: Element) => void (Opcjonalnie) Opcjonalna metoda deserializacji służąca do definiowania sposobu deserializacji stanu mutacji z pliku XML. Należy to połączyć z definiowaniem mutationToDom.
getDeweloperZmienne? () => ciąg[] (Opcjonalnie) Opcjonalna właściwość do deklarowania zmiennych programisty. Zwraca listę nazw zmiennych do użycia przez generatory. Zmienne programisty nie są nigdy wyświetlane użytkownikowi, ale są deklarowane w wygenerowanym kodzie jako zmienne globalne.
kapelusz? ciąg znaków (Opcjonalnie) Nazwa typu kapelusza.
helpUrl string | Function | null Ciąg znaków pomocy dotyczącej bloku lub funkcji zwracającej adres URL. Brak pomocy.
ikony IIcon[]
id ciąg znaków
init? () => void (Opcjonalnie) Opcjonalna metoda wywoływana podczas inicjowania.
inputList Wejście[]
inputsInline? boolean (Opcjonalnie)
inputsInlineDefault? boolean (Opcjonalnie)
isInFlyout boolean
isInMutator boolean
isInsertionMarker_ protected boolean Prawda, jeśli ta blok jest znacznikiem wstawiania.
loadExtraState? (p1: dowolna) => void (Opcjonalnie) Opcjonalna metoda serializacji służąca do określania sposobu deserializacji dodatkowego stanu bloku (np. stanu mutacji) z obiektu zgodnego z plikiem JSON. Należy to połączyć z definiowaniem saveExtraState.
mutationToDom? (...p1: dowolna[]) => Element (Opcjonalnie) Opcjonalna metoda serializacji określająca sposób serializacji stanu mutacji do formatu XML. Należy to połączyć z definiowaniem domToMutation.
nextConnection Połączenie | null
onchange? ((p1: Abstract) => void) | null (Opcjonalnie) Opcjonalna metoda wywołania zwrotnego używana w przypadku zmiany nadrzędnego obszaru roboczego bloku. To wywołanie jest zwykle wywoływane przez konstruktor, funkcję inicjatora typu bloku lub funkcję inicjatora rozszerzeń.
outputConnection Połączenie | null
outputShape_ protected liczba | null
parentBlock_ protected ten | null
previousConnection Połączenie | null
wyrenderowano boolean | null
RTL boolean
saveExtraState? (doFullSerialization?: boolean) => dowolna (Opcjonalnie) Opcjonalna metoda serializacji służąca do określania sposobu serializacji dodatkowego stanu bloku (np. stanu mutacji) na coś zgodnego z plikiem JSON. Należy to połączyć z definiowaniem loadExtraState.
styleName_ protected ciąg znaków Nazwa stylu bloku.
suppressPrefixSuffix boolean | null Opcjonalna właściwość pozwalająca pominąć dodawanie elementów STATEMENT_PREFIX i STATEMENT_SUFFIX do wygenerowanego kodu.
etykietka Tooltip.TipInfo
type ciąg znaków
obszar roboczy Workspace

Metody

Metoda Modyfikatory Opis
addIcon(icon) Dodaje podaną ikonę do bloku.
allInputsFilled(opt_shadowBlocksAreFilled) Sprawdza rekurencyjnie, czy wszystkie dane wejściowe instrukcji i wartości są wypełnione blokami. Sprawdza także wszystkie następujące bloki instrukcji w tym stosie.
appendDummyInput(name) Dodaje fikcyjny wiersz danych wejściowych.
appendEndRowInput(name) Dodaje dane wejściowe, które kończą wiersz.
appendInput(input)

Dodaje podany wiersz wejściowy.

Umożliwia dołączenie do bloku niestandardowych danych wejściowych.

appendStatementInput(name) Dodaje wiersz wejściowy instrukcji.
appendValueInput(name) Dodaje wiersz wejściowy wartości.
bumpNeighbours() Wyrównuj niepołączone bloki z wyrównania. Dwie niepołączone bryły nie powinny być umieszczone w jednej linii na ekranie.
dispose(healStack) Pozbądź się tej bryły.
disposeInternal() protected Pozbywa się tej bloku bez wykonania czynności wymaganych przez blok górny. Na przykład nie uruchamia zdarzeń, nie odłącza bloku itd.
doInit_() protected Wywołuje funkcję init() i obsługuje powiązane uruchamianie zdarzeń itd.
getChildren(ordered) Znajdź wszystkie bloki bezpośrednio zagnieżdżone w tej. Zawiera dane wejściowe związane z wartością i wyrażeniem, a także dowolne następujące stwierdzenie. Wyklucza dowolne połączenie na karcie wyników lub dowolnej poprzedzającej tę instrukcję. Bloki są opcjonalnie sortowane według pozycji od góry do dołu.
getColour() Uzyskaj kolor bryły.
getCommentText() Zwraca komentarz do tego bloku (lub wartość null, jeśli nie ma komentarza).
getDescendants(ordered) Znajdź wszystkie bloki, które są w niej bezpośrednio lub pośrednio zagnieżdżone. Uwzględnia ten blok na liście. Obejmuje dane wejściowe związane z wartością i wyrażeniem, a także wszelkie poniższe stwierdzenia. Wyklucza dowolne połączenie na karcie wyników i dowolne wcześniejsze instrukcje. Bloki są opcjonalnie sortowane według pozycji od góry do dołu.
getField(name) Zwraca nazwane pole z bloku.
getFieldValue(name) Zwraca neutralną dla języka wartość danego pola.
getHue(), Pobierz wartość odcienia HSV bloku. Jeśli nie ustawiono odcienia, wartość null.
getIcon(type)
getIcons()
getInheritedDisabled() Sprawdzaj, czy blokada jest wyłączona przez rodziców. Wyłączona właściwość bloku nie jest brana pod uwagę.
getInput(name) Pobiera nazwany obiekt wejściowy.
getInputsInline() Sprawdź, czy dane wejściowe o wartości są ułożone poziomo czy pionowo.
getInputTargetBlock(name) Pobiera blok dołączony do nazwanych danych wejściowych.
getInputWithBlock(block) Zwraca dane wejściowe łączące się z określonym blokiem.
getNextBlock() Zwraca blok następnego wyrażenia połączonego bezpośrednio z tym blokiem.
getOutputShape() Pobierz kształt wyjściowy bryły.
getParent() Zwraca blok nadrzędny lub wartość null, jeśli ten blok znajduje się na najwyższym poziomie. Blok nadrzędny to blok połączony z poprzednim połączeniem (w przypadku bloku instrukcji) lub blok połączony z połączeniem wyjściowym (w przypadku bloku wartości).
getPreviousBlock() Zwraca blok połączony z poprzednim połączeniem.
getRelativeToSurfaceXY(), Zwraca współrzędne lewego górnego rogu tej bryły względem punktu początkowego powierzchni rysowania (0,0) w jednostkach obszaru roboczego.
getRootBlock() Zwraca bryłę najwyższego poziomu w drzewie tego bloku. Blokada zostanie zwrócona, jeśli znajduje się na najwyższym poziomie.
getStyleName() Pobierz nazwę stylu bloku.
getSurroundParent() Return the parent block that surrounds the current block, or null if this block has no surrounding block. Blok nadrzędny może być po prostu poprzednią instrukcją, natomiast otaczający go blok to instrukcja if, pętla itp.
getTooltip() Zwraca tekst etykietki tego bloku.
getVars() Zwraca wszystkie zmienne, do których odwołuje się ten blok.
hasIcon(type)
initModel() Wywołaj initModel we wszystkich polach bloku. Można wywołać więcej niż raz. Po utworzeniu bloku, ale przed pierwszą interakcją z nim, należy wywołać initModel lub initSvg. Do interakcji należą działania interfejsu użytkownika (np. kliknięcie i przeciąganie) oraz zdarzenia uruchamiania (np. tworzenie, usuwanie i zmienianie).
isCollapsed() Sprawdzanie, czy blok jest zwinięta.
isDeletable() Sprawdź, czy można usunąć tę blokadę.
isDisposed() Zwraca, jeśli ten blok został zutylizowany / usunięty.
isDuplicatable() Określ, czy blok można powielić. Jeśli zduplikujesz ten blok i elementy podrzędne, blok ten przekroczy pojemność obszaru roboczego. Jeśli zduplikowanie tego bloku i elementów podrzędnych spowoduje umieszczenie dowolnego typu na instancji maxInstance, ten blok nie będzie duplikowany.
isEnabled() Sprawdź, czy ta blokada jest włączona.
isInsertionMarker() Ustal, czy ta blokada jest blokiem znacznika wstawiania czy nie.
isOwnDeletable() Zwraca, czy właściwość możliwa do usunięcia tego bloku ma wartość prawda czy fałsz.
isOwnEditable() Zwraca wartość określającą, czy właściwość do edycji tego bloku ma wartość true (prawda) czy false (fałsz).
isShadow() Określ, czy blok jest blokiem cienia.
jsonInit(json) Zainicjuj ten blok, używając wieloplatformowego opisu w formacie JSON, który ułatwia internacjonalizację.
mixin(mixinObj, opt_disableCheck) Dodaj pary klucz-wartość z miksinObj do tego obiektu bloku. Domyślnie ta metoda sprawdza, czy klucze w miksinObj nie zastąpią istniejących wartości w bloku, w tym wartości prototypu. Zapewnia to pewną ochronę przed niezgodnością z różnymi rozszerzeniami i funkcjami blokowania w przyszłości. To ustawienie można wyłączyć, przekazując jako drugi argument wartość „prawda”.
moveBy(dx, dy, powód) Przesuwa bryłę o przesunięcie względne.
moveInputBefore(name, refName) Przenieś nazwane dane wejściowe do innej lokalizacji w tym bloku.
moveNumberedInputBefore(inputIndex, refIndex) Przenieś ponumerowane dane wejściowe do innej lokalizacji w tym bloku.
removeIcon(type) Usuwa z bloku ikonę, której metoda getType pasuje do podanego typu ikony.
removeInput(name, opt_quiet) Usuń dane wejściowe z tego bloku.
renameVarById(oldId; newId) Powiadomienie o zmianie nazwy zmiennej. Jeśli identyfikator jest zgodny z jedną ze zmiennych tego bloku, zmień jego nazwę.
setCollapsed(collapsed) Określ, czy bloka ma być zwinięta.
setColour(colour) Zmień kolor bloku.
setCommentText(text) Ustaw tekst komentarza do tego bloku.
setDeletable(deletable) Określ, czy można usunąć tę blokadę.
setEditable(editable) Określ, czy bryła można edytować.
setEnabled(enabled) Określ, czy blokada ma być włączona.
setFieldValue(newValue, name) Ustawia wartość danego pola dla tego bloku.
setHelpUrl(url) Ustaw adres URL strony pomocy dotyczącej tego bloku.
setInputsInline(newBoolean) Określ, czy dane wejściowe mają być ułożone poziomo czy pionowo.
setMovable(movable) Określ, czy tę bryłę można przenosić czy nie.
setMutator(_mutator) Dodaj do tego bloku okno mutatora.
setNextStatement(newBoolean, opt_check) Określ, czy inna bryła może przylegać do łańcucha na jej spodzie.
setOnChange(onchangeFn) Konfiguruje funkcję wywołania zwrotnego, która ma być używana w przypadku zmiany nadrzędnego obszaru roboczego bloku, zastępując wszystkie wcześniejsze moduły obsługi onchange. To wywołanie jest zwykle wywoływane przez konstruktor, funkcję inicjatora typu bloku lub funkcję inicjatora rozszerzeń.
setOutput(newBoolean, opt_check) Określ, czy ten blok zwraca wartość.
setOutputShape(outputShape) Ustaw kształt wyjściowy bryły.
setPreviousStatement(newBoolean, opt_check) Określ, czy blok może przechodzić w łańcuch na spód innej bryły.
setStyle(blockStyleName) Ustaw wartości stylu i koloru bloku.
setTooltip(newTip) Ustawia etykietkę tego bloku.
setWarningText(_text, _opt_id) Ustaw tekst ostrzeżenia dla tego bloku.
toDevString()

Ta metoda zwraca ciąg opisujący ten blok w warunkach dla programistów (nazwa i identyfikator, tylko w języku angielskim).

Przeznaczona do użycia w logach i błędach konsoli. Jeśli potrzebujesz ciągu znaków w języku ojczystym użytkownika (w tym w tekście blokowym, wartościach pól i blokach podrzędnych), użyj funkcji [toString()].

toString(opt_maxLength, opt_emptyToken) Utwórz zrozumiałą dla człowieka reprezentację tego bloku i wszystkich elementów podrzędnych.
unplug(opt_healStack) Odłącz ten blok od górnego bloku. Jeśli ten blok jest instrukcją, opcjonalnie połącz pod nim blok z blokiem na górze.