Klasa BlockSvg
Klasa reprezentacji SVG bloku. Zwykle nie jest wywoływana bezpośrednio. Zalecane jest użycie workspace.newBlock().
Podpis:
export declare class BlockSvg extends Block implements IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable, IFocusableNode
Rozszerza: Blok
Implementuje: IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable, IFocusableNode
Zespoły
| Zespół | Modyfikatory | Opis |
|---|---|---|
| (constructor)(workspace, prototypeName, opt_id) | Tworzy nową instancję klasy BlockSvg |
Właściwości
| Właściwość | Modyfikatory | Typ | Opis |
|---|---|---|---|
| COLLAPSED_WARNING_ID |
|
(nie zadeklarowano) | Identyfikator ostrzeżenia „zwinięte ostrzeżenia”. Umożliwia usunięcie ostrzeżenia „zwinięte ostrzeżenia” bez usuwania ostrzeżeń należących do bloku. |
| customContextMenu? | (p1: Array<ContextMenuOption | LegacyContextMenuOption>) => void | (Opcjonalnie) | |
| rozłożyć? | (p1: Workspace) => BlockSvg | (Opcjonalnie) | |
| height | liczba | Wysokość tego bloku, bez uwzględnienia bloków instrukcji powyżej lub poniżej. Wysokość jest podana w jednostkach obszaru roboczego. | |
| INLINE |
|
(nie zadeklarowano) | Stała do identyfikowania wierszy, które mają być renderowane w tekście. Nie powoduj kolizji z wartościami Blockly.inputTypes. |
| mutator | MutatorIcon | null | Ikona mutatora bloku (jeśli występuje). | |
| nextConnection | RenderedConnection | ||
| outputConnection | RenderedConnection | ||
| previousConnection | RenderedConnection | ||
| rendered | readonly |
(nie zadeklarowano) | Czy ten blok jest blokiem BlockSVG? |
| saveConnections? | (rootBlock: BlockSvg) => void | (Opcjonalnie) Opcjonalna metoda, która zapisuje rekord bloków połączonych z tym blokiem, aby można je było później przywrócić po ponownym złożeniu (ponownej konfiguracji) tego bloku. Zwykle rejestruje połączone bloki we właściwościach bloków w menu wysuwanym mutatora, dzięki czemu po zmianie kolejności tych bloków komponentów automatycznie zmieni się kolejność odpowiednich połączonych bloków w tym bloku po jego ponownym utworzeniu. Aby zapisane informacje o połączeniu były aktualne, MutatorIcon ustawia odbiornik zdarzeń, który wywołuje tę metodę za każdym razem, gdy otwarte jest wysuwane menu mutatora i w obszarze roboczym tego bloku nastąpi zmiana. |
|
| styl | BlockStyle | ||
| width | liczba | Szerokość tego bloku, w tym wszystkich połączonych bloków wartości. Szerokość jest podana w jednostkach obszaru roboczego. | |
| workspace | WorkspaceSvg |
Metody
| Metoda | Modyfikatory | Opis |
|---|---|---|
| addClass(className) | Dodaj klasę CSS do grupy SVG tego bloku. | |
| addIcon(icon) | ||
| addSelect() | Dodaje do bloku efekt wizualny „wybierz”, ale nie wybiera go ani nie wywołuje zdarzenia. | |
| appendInput(input) | ||
| bringToFront(blockOnly) | Przenieś ten blok na początek widocznego obszaru roboczego. Tagi |
|
| bumpNeighbours() | Powoduje przesunięcie niepołączonych bloków. Dwa bloki, które nie są ze sobą połączone, nie powinny przypadkowo znajdować się w jednej linii na ekranie, ponieważ wprowadza to użytkowników w błąd. |
|
| calculateContextMenuLocation(e) | protected |
Pobiera lokalizację, w której ma być wyświetlane menu kontekstowe tego bloku. Użyj lokalizacji kliknięcia, jeśli blok został kliknięty, lub lokalizacji opartej na polach bloku w innym przypadku. |
| canBeFocused() | Zobacz IFocusableNode.canBeFocused. | |
| checkAndDelete() | Usuń blok i ukryj plewy. Jeśli blok znajduje się w menu wysuwanym, nie zostanie usunięty. Jest to tzw. pełne usuwanie, które można wywołać z menu kontekstowego i za pomocą skrótów klawiszowych. Jeśli usuwasz blok z obszaru roboczego i nie musisz sprawdzać wysuwanych menu, obsługiwać grupowania zdarzeń ani ukrywać plew, użyj bezpośrednio funkcji block.dispose(). |
|
| dispose(healStack, animate) | Usuń ten blok. | |
| disposeInternal() | Usuwa ten blok bez wykonywania czynności wymaganych przez blok najwyższego poziomu. np. wywołuje efekty interfejsu, usuwa węzły itp. | |
| drag(newLoc, e) | Przeciąga blok w podane miejsce. | |
| endDrag(e) | Kończy przeciąganie bloku. | |
| generateContextMenu(e) | protected |
Wygeneruj menu kontekstowe dla tego bloku. |
| getBoundingRectangle() | Zwraca współrzędne ramki ograniczającej opisującej wymiary tego bloku i wszystkich bloków ułożonych pod nim. Układ współrzędnych: współrzędne obszaru roboczego. | |
| getBoundingRectangleWithoutChildren() | Zwraca współrzędne ramki ograniczającej opisującej wymiary tego bloku. Układ współrzędnych: współrzędne obszaru roboczego. | |
| getChildren(ordered) | Znajdź wszystkie bloki bezpośrednio zagnieżdżone w tym bloku. Obejmuje dane wejściowe wartości i oświadczeń, a także wszelkie kolejne oświadczenia. Wyklucza wszelkie połączenia na karcie wyjściowej lub w poprzednim wyrażeniu. Bloki są opcjonalnie sortowane według pozycji od góry do dołu. | |
| getColour() | Pobierz kolor bloku. | |
| getColourSecondary() | Pobierz drugorzędny kolor bloku. | |
| getColourTertiary() | Pobierz trzeciorzędny kolor bloku. | |
| getFocusableElement() | Zobacz IFocusableNode.getFocusableElement. | |
| getFocusableTree() | Zobacz IFocusableNode.getFocusableTree. | |
| getNextBlock() | Zwróć następny blok instrukcji bezpośrednio połączony z tym blokiem. | |
| getPreviousBlock() | Zwraca blok połączony z poprzednim połączeniem. | |
| getRelativeToSurfaceXY() | Zwróć współrzędne lewego górnego rogu tego bloku względem początku powierzchni rysowania (0,0) w jednostkach obszaru roboczego. Jeśli blok znajduje się w obszarze roboczym, punkt (0, 0) jest początkiem układu współrzędnych obszaru roboczego. Nie zmienia się ona wraz z rozmiarem obszaru roboczego. | |
| getStyle() | Zwraca obiekt BlockStyle używany do stylizowania tego bloku. | |
| getSvgRoot() | Zwraca węzeł główny SVG lub wartość null, jeśli nie istnieje. | |
| initSvg() | Utwórz i zainicjuj reprezentację SVG bloku. Może być wywoływana więcej niż raz. | |
| isCopyable() | Zwraca informację, czy ten blok można skopiować. | |
| isMovable() | Zwraca informację, czy ten blok można przenieść. | |
| jsonInit(json) | ||
| markDirty() | Powiadom każdy element wejściowy w tym bloku, aby oznaczyć jego pola jako zmodyfikowane. Zanieczyszczone pole to pole, które wymaga ponownego renderowania. | |
| moveBy(dx, dy, reason) | Przesuń blok o względne przesunięcie. | |
| moveNumberedInputBefore(inputIndex, refIndex) | Przenieś ponumerowane dane wejściowe w inne miejsce w tym bloku. | |
| moveTo(xy, reason) | przesuwać blok na wybrane miejsce; | |
| onNodeBlur() | Zobacz IFocusableNode.onNodeBlur. | |
| onNodeFocus() | Zobacz IFocusableNode.onNodeFocus. | |
| removeClass(className) | Usuń klasę CSS z grupy SVG tego bloku. | |
| removeIcon(type) | ||
| removeInput(name, opt_quiet) | Usuń dane wejściowe z tego bloku. | |
| removeSelect() | Usuwa z bloku efekt wizualny „wybierz”, ale nie cofa wyboru ani nie wywołuje zdarzenia. | |
| render() | Natychmiast rozmieszcza i przekształca blok na podstawie jego zawartości i ustawień. | |
| revertDrag() | Przenosi blok z powrotem do miejsca, w którym znajdował się na początku przeciągania. | |
| scheduleSnapAndBump() | Przyciąganie do siatki, a następnie odsuwanie sąsiednich bloków na końcu następnego renderowania. | |
| select() | Wybiera ten blok. Wyróżnia blok wizualnie. | |
| setCollapsed(collapsed) | Określ, czy blok ma być zwinięty. | |
| setColour(colour) | Zmień kolor bloku. | |
| setDeletable(deletable) | Dodaj klasę blocklyNotDeletable, gdy blok nie jest usuwalny, lub usuń klasę, gdy blok jest usuwalny. | |
| setDisabledReason(disabled, reason) | Dodaj lub usuń powód, dla którego blokada może zostać wyłączona. Jeśli blok ma jakiekolwiek powody, aby zostać wyłączony, zostanie uznany za wyłączony. Blokada może być wyłączona z wielu niezależnych od siebie powodów, np. gdy użytkownik wyłączy ją ręcznie lub gdy jest ona nieprawidłowa. | |
| setDragStrategy(dragStrategy) | Ustawia strategię przeciągania dla tego bloku. | |
| setEditable(editable) | Określ, czy ten blok można edytować. | |
| setHighlighted(highlighted) | Określ, czy blok ma być podświetlony. Blokowe wyróżnianie jest często używane do wizualnego oznaczania bloków, które są obecnie wykonywane. | |
| setInputsInline(newBoolean) | Określ, czy dane wejściowe wartości mają być rozmieszczone poziomo czy pionowo. | |
| setMovable(movable) | Określ, czy ten blok można przenosić. | |
| setMutator(mutator) | Nadaj temu blokowi okno dialogowe mutatora. | |
| setNextStatement(newBoolean, opt_check) | Określ, czy do dołu tego bloku można dołączyć kolejny blok. | |
| setOutput(newBoolean, opt_check) | Określ, czy ten blok zwraca wartość. | |
| setPreviousStatement(newBoolean, opt_check) | Określ, czy ten blok może być połączony z innym blokiem u dołu. | |
| setStyle(blockStyleName) | Ustaw wartości stylu i koloru bloku. | |
| setWarningText(text, id) | Ustaw tekst ostrzeżenia tego bloku. | |
| snapToGrid() | Przyciągnij ten blok do najbliższego punktu siatki. | |
| startDrag(e) | Rozpoczyna przeciąganie bloku. | |
| toCopyData() | Zakoduj blok do skopiowania. | |
| toFlyoutInfo() | Zwraca reprezentację tego bloku, którą można wyświetlić w wyskakującym okienku. | |
| translate(x, y) | Przekształca blok, ustawiając translację w atrybucie transform pliku SVG bloku. | |
| unselect() | Odznacza ten blok. Wizualnie usuwa wyróżnienie bloku. |