blockly > BlockSvg

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

static

readonly

(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

static

readonly

(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 nie uwzględniają indeksu z, więc SVG renderuje je w kolejności, w jakiej występują w DOM. Umieszczenie tego bloku na początku sekcji w grupie bloków spowoduje, że będzie on renderowany nad innymi blokami. Używaj tej metody oszczędnie, ponieważ jest kosztowna ze względu na zmianę kolejności węzłów DOM.
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.