Zablokuj zajęcia
Klasa dla 1 bloku. Zwykle nie jest wywoływana bezpośrednio. Preferowana jest metoda workspace.newBlock().
Podpis:
export declare class Block implements IASTNodeLocation
Implementuje: IASTNodeLocation
Zespoły
Zespół | Modyfikatory | Opis |
---|---|---|
(constructor)(workspace, prototypeName, opt_id) | Tworzy nową instancję klasy Block |
Właściwości
Właściwość | Modyfikatory | Typ | Opis |
---|---|---|---|
childBlocks_ | protected |
to[] | |
collapsed_ | protected |
wartość logiczna | |
COLLAPSED_FIELD_NAME |
|
ciąg znaków | Identyfikator neutralny dla języka nadany zwiniętemu polu. |
COLLAPSED_INPUT_NAME |
|
ciąg znaków | Identyfikator neutralny dla języka nadany zwiniętej stronie. |
colour_ | protected |
ciąg znaków | Kolor bryły w polu „#RRGGBB” . |
utworzyć? | (p1: Blokowanie) => nieważne | (Opcjonalnie) opcjonalna funkcja, która ponownie konfiguruje blok na podstawie zawartości okna mutatora. | |
contextMenu | wartość logiczna | ||
dane | ciąg znaków | wartość null | Opcjonalne dane tekstowe, które powodują błądzenia między blokami i kodem XML. Brak efektu. Mogą być używane przez inne firmy do podawania metadanych. | |
rozłożyć? | (1: Obszar roboczy) => Zablokuj | (Opcjonalnie) opcjonalna funkcja, która wypełnia okno mutatora komponentami tego bloku. | |
zniszczyć? | () => nieważne | (Opcjonalnie) Metoda opcjonalna wywoływana podczas utylizacji. | |
utylizacja | protected |
wartość logiczna | Czy bieżący blok jest obecnie usuwany? |
domToMutation? | (p1: Element) => nieważne | (Opcjonalnie) Opcjonalna metoda deserializacji definiowania sposobu deserializacji stanu mutacji z kodu XML. Należy to połączyć ze zdefiniowaniem zasady mutationToDom . |
|
getDeveloperVariables? | () => ciąg znaków[] | (Opcjonalnie) Opcjonalna właściwość do deklarowania zmiennych programisty. Zwraca listę nazw zmiennych do wykorzystania przez generatory. Zmienne programisty nigdy nie są wyświetlane użytkownikowi, ale są deklarowane w wygenerowanym kodzie jako zmienne globalne. | |
kapelusz? | ciąg znaków | (Opcjonalnie) Nazwa rodzaju kapelusza. | |
helpUrl | ciąg znaków | Funkcja | wartość null | Ciąg znaków pomocy dotyczącej blokowania lub funkcji, która zwraca adres URL. Wartość null oznacza brak pomocy. | |
ikony | IIcon[] | ||
id | ciąg znaków | ||
zainicjować? | () => nieważne | (Opcjonalnie) Metoda opcjonalna wywoływana podczas inicjowania. | |
inputList | Dane wejściowe[] | ||
inputsInline? | wartość logiczna | (Opcjonalnie) | |
inputsInlineDefault? | wartość logiczna | (Opcjonalnie) | |
isInFlyout | wartość logiczna | ||
isInMutator | wartość logiczna | ||
isInsertionMarker_ | protected |
wartość logiczna | Prawda, jeśli ten blok jest znacznikiem wstawiania. |
loadExtraState? | (p1: dowolny) => nieważne | (Opcjonalnie) Opcjonalna metoda serializacji, która określa sposób deserializacji dodatkowego stanu bloku (np. stanu mutacji) z kodu zgodnego z JSON. Należy to połączyć ze zdefiniowaniem zasady saveExtraState . |
|
mutationToDom? | (...p1: dowolny[]) => Żywioł | (Opcjonalnie) Opcjonalna metoda serializacji określająca sposób serializowania stanu mutacji do kodu XML. Należy to połączyć ze zdefiniowaniem zasady domToMutation . |
|
nextConnection | Połączenie | wartość null | ||
onchange? | ((p1: Streszczenie) => nieważne) | wartość null | (Opcjonalnie) Opcjonalna metoda wywołania zwrotnego używana po każdej zmianie nadrzędnego obszaru roboczego bloku. Jest ona zwykle wywoływana tylko z konstruktora, funkcji inicjatora typu blokowego lub funkcji inicjatora rozszerzenia. | |
outputConnection | Połączenie | wartość null | ||
outputShape_ | protected |
liczba | wartość null | |
parentBlock_ | protected |
to | wartość null | |
previousConnection | Połączenie | wartość null | ||
wyrenderowano | readonly |
wartość logiczna | Czy to blokuje BlockSVG? |
RTL | wartość logiczna | ||
saveExtraState? | (doFullSerialization?: boolean) => wszystkie | (Opcjonalnie) Opcjonalna metoda serializacji określająca sposób serializowania dodatkowego stanu bloku (np. stanu mutacji) do czegoś zgodnego z JSON. Należy to połączyć ze zdefiniowaniem zasady loadExtraState . |
|
styleName_ | protected |
ciąg znaków | Nazwa stylu bloku. |
suppressPrefixSuffix | boolean | wartość null | Opcjonalna właściwość pomijania dodawania 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 bryły. | |
allInputsFilled(opt_shadowBlocksAreFilled) | Cyklicznie sprawdza, czy wszystkie dane wejściowe instrukcji i wartości są wypełnione blokami. Sprawdza też wszystkie poniższe bloki instrukcji w tym stosie. | |
appendDummyInput(name) | Dodaje fikcyjny wiersz danych wejściowych. | |
appendEndRowInput(name) | Dodaje dane wejściowe kończące wiersz. | |
appendInput(input) | Dołącza podany wiersz danych wejściowych. 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() | Odsuń niepołączone bloki tak, by nie wyrównać. Dwa bryły, które w rzeczywistości nie są ze sobą połączone, nie powinny przypadkowo znaleźć się w jednej linii na ekranie. | |
dispose(healStack) | Pozbądź się tej blokady. | |
disposeInternal() | protected |
Usuwa ten blok bez wykonywania czynności wymaganych przez górny blok. Na przykład: nie uruchamia zdarzeń, nie odłącza bloku itp. |
doInit_() | protected |
Wywołuje funkcję init(), obsługuje powiązane uruchamianie zdarzeń itp. |
getChildren(ordered) | Znajdź wszystkie bryły zagnieżdżone bezpośrednio w tym budynku. Obejmuje dane wejściowe wartości i instrukcji, a także dowolne poniższe instrukcje. Wyklucza połączenia na karcie wyników lub w poprzedzającej je instrukcji. Blokady są opcjonalnie sortowane według pozycji. od góry do dołu. | |
getColour() | Znajdź kolor bryły. | |
getCommentText() | Zwraca komentarz dotyczący tego bloku (lub wartość null w przypadku braku komentarza). | |
getDescendants(ordered) | Znajdź wszystkie bryły, które są w nim bezpośrednio lub pośrednio zagnieżdżone. Zawiera ten blok na liście. Obejmuje dane wejściowe wartości i instrukcji, a także poniższe instrukcje. Wyklucza połączenia na karcie wyników i poprzedzające instrukcje. Blokady są opcjonalnie sortowane według pozycji. od góry do dołu. | |
getDisabledReasons() | Jeśli tak, podaj ewentualne powody, dla których blokada jest obecnie wyłączona. Jeśli blok jest włączony, zestaw jest pusty. | |
getField(name) | Zwraca nazwane pole z bloku. | |
getFieldValue(name) | Zwraca neutralną dla języka wartość danego pola. | |
getHue() | Pobierz wartość barwy HSV dla bloku. Wartość null, jeśli nie ustawiono barwy. | |
getIcon(type) | ||
getIcons() | ||
getInheritedDisabled() | Dowiedz się, czy blokada została wyłączona z powodu rodziców. Własna wyłączona właściwość bloku nie jest brana pod uwagę. | |
getInput(name) | Pobiera nazwany obiekt wejściowy. | |
getInputsInline() | Sprawdź, czy wpisane wartości są ustawione 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 następny blok instrukcji bezpośrednio połączony z tym blokiem. | |
getOutputShape() | Pobierz kształt wyjściowy bryły. | |
getParent() | Zwraca blok nadrzędny lub wartość null, jeśli ten blok jest na najwyższym poziomie. Blok nadrzędny to albo blok połączony z poprzednim połączeniem (w przypadku bloku instrukcji) albo blok podłączony do połączenia wyjściowego (blok 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() | Zwróć najwyższą bryłę w drzewie tego bloku. Zwróci się, jeśli ta bloka jest na najwyższym poziomie. | |
getStyleName() | Uzyskaj nazwę stylu bloku. | |
getSurroundParent() | Zwraca blok nadrzędny, który otacza bieżący blok, lub wartość null, jeśli nie ma otaczającej go bryły. Blok nadrzędny może być po prostu poprzednią instrukcją, podczas gdy otaczający go blok to instrukcja if, loop itd. | |
getTooltip() | Zwraca tekst etykietki dla tego bloku. | |
getVars() | Zwraca wszystkie zmienne, do których odwołuje się ten blok. | |
hasDisabledReason(reason) | Sprawdź, czy blokada jest obecnie wyłączona z podanego powodu. | |
hasIcon(type) | ||
initModel() | Wywołaj initModel we wszystkich polach w bloku. Można wywołać więcej niż raz. Po utworzeniu bloku i przed pierwszą interakcją z nim trzeba wywołać metodę initModel lub initSvg. Interakcje obejmują działania w interfejsie (np. klikanie i przeciąganie) oraz wywoływanie zdarzeń (np. tworzenie, usuwanie i zmiana). | |
isCollapsed() | Sprawdź, czy bryła jest zwinięty czy nie. | |
isDeletable() | Sprawdź, czy można usunąć tę blokadę. | |
isDisposed() | Zwracany, jeśli blok został pozbyty się lub usunięty. | |
isDuplicatable() | Sprawdź, czy blok można duplikować. Jeśli zduplikujesz ten blok i jego bloki podrzędne, spowoduje to nadpisanie go nad pojemnością obszaru roboczego. Jeśli zduplikujesz ten blok i bloki podrzędne, zastąpi on dowolny typ w swojej instancji maksymalnej, ten blok nie będzie się duplikować. | |
isEnabled() | Sprawdź, czy ta blokada jest włączona. Blokada jest uznawana za włączoną, jeśli nie ma żadnych powodów, dla których zostałaby wyłączona. Blokada może być nadal wyłączona z innych powodów, nawet jeśli użytkownik spróbuje włączyć ją ręcznie, np. gdy blokada będzie w nieprawidłowej lokalizacji. | |
isInsertionMarker() | Sprawdź, czy ta bloka jest blokiem znacznika wstawiania. | |
isOwnDeletable() | Zwraca, czy własna właściwość tego bloku, którą można usunąć, ma wartość true (prawda) lub false (fałsz). | |
isOwnEditable() | Zwróć uwagę, czy edytowalna właściwość tego bloku ma wartość true (prawda) czy false (fałsz). | |
isShadow() | Sprawdź, czy ta bryła jest blokiem cienia. | |
jsonInit(json) | Zainicjuj ten blok, korzystając z dostosowanego do potrzeb internacjonalizacji opisu w formacie JSON. | |
mixin(mixinObj, opt_disableCheck) | Dodaj pary klucz-wartość z MixinObj do tego obiektu bloku. Domyślnie ta metoda sprawdza, czy klucze w kombinacji MixinObj nie zastępują istniejących wartości w bloku, w tym wartości prototypowych. Zapewni to pewną ochronę przed niezgodnościami kombinacji i rozszerzeń z przyszłymi funkcjami blokowymi. Tę kontrolę można wyłączyć, przekazując wartość „prawda” jako drugi argument. | |
moveBy(dx, dy, powód) | Przesuwanie bryły o przesunięcie względne. | |
moveInputBefore(name, refName) | Przenieś nazwane dane wejściowe do innej lokalizacji w tym bloku. | |
moveNumberedInputBefore(inputIndex, refIndex) | Przenieś numerowane dane wejściowe do innej lokalizacji tego bloku. | |
removeIcon(type) | Usuwa z bloku ikonę, której metoda getType pasuje do danego typu iconType. | |
removeInput(name, opt_quiet) | Usuń kolumnę wejściową z tego bloku. | |
renameVarById(staryId, nowyId) | Powiadomienie o zmianie nazwy zmiennej. Jeśli identyfikator pasuje do jednej ze zmiennych tego bloku, zmień jego nazwę. | |
setCollapsed(collapsed) | Określ, czy bryła ma być zwinięty czy nie. | |
setColour(colour) | Zmień kolor bryły. | |
setCommentText(text) | Ustaw tekst komentarza do tego bloku. | |
setDeletable(deletable) | Określ, czy można usunąć tę blokadę. | |
setDisabledReason(disabled, reason) | Dodaj lub usuń przyczynę, dla której blokada może zostać wyłączona. Jeśli blokada ma jakiekolwiek powody, to ona zostanie uznana za wyłączoną. Blokada może zostać wyłączona z kilku niezależnych powodów jednocześnie, np. gdy użytkownik wyłączy ją ręcznie lub gdy blokada będzie nieprawidłowa. | |
setEditable(editable) | Określ, czy tę bryłę można edytować. | |
setEnabled(enabled) | ||
setFieldValue(newValue, name) | Ustawia wartość danego pola dla tego bloku. | |
setHelpUrl(url) | Ustaw adres URL strony pomocy dotyczącej blokowania. | |
setInputsInline(newBoolean) | Określ, czy wpisane wartości mają być rozmieszczone poziomo czy pionowo. | |
setMovable(movable) | Określ, czy blok można przenieść. | |
setMutator(_mutator) | Daj temu blokowi okno mutatora. | |
setNextStatement(newBoolean, opt_check) | Określ, czy inna bryła może być przyłączona do dolnej części tej bryły. | |
setOnChange(onchangeFn) | Ustawia funkcję wywołania zwrotnego do użycia po każdej zmianie nadrzędnego obszaru roboczego bloku, zastępując dowolny wcześniejszy moduł obsługi onchange. Jest ona zwykle wywoływana tylko z konstruktora, funkcji inicjatora typu blokowego lub funkcji inicjatora rozszerzenia. | |
setOutput(newBoolean, opt_check) | Określ, czy blok ma zwracać wartość. | |
setOutputShape(outputShape) | Ustaw docelowy kształt bryły. | |
setPreviousStatement(newBoolean, opt_check) | Określ, czy ta bryła może być przyłączona do dolnej części innej bryły. | |
setStyle(blockStyleName) | Ustaw styl i kolor bryły. | |
setTooltip(newTip) | Ustawia etykietkę dla tego bloku. | |
setWarningText(_text, _opt_id) | Ustaw tekst ostrzeżenia dla tego bloku. | |
toDevString() | Ta metoda zwraca ciąg znaków opisujący ten blok w kontekście programistycznym (nazwa i identyfikator; tylko w języku angielskim). Przeznaczony do użytku w logach i błędach konsoli. Jeśli potrzebujesz ciągu znaków w języku ojczystym użytkownika (w tym tekstu blokowego, wartości pól i bloków podrzędnych), użyj funkcji [toString()]. |
|
toString(opt_maxLength, opt_emptyToken) | Utwórz czytelną dla człowieka reprezentację tekstową tego bloku i wszelkich elementów podrzędnych. | |
unplug(opt_healStack) | Odłącz ten blok od nadrzędnego bloku. Jeśli ten blok jest instrukcją, opcjonalnie połącz blok u dołu, umieszczając blok na górze. |