Class BlockSvg
Class untuk representasi SVG blok. Biasanya tidak dipanggil secara langsung, workspace.newBlock() lebih disukai.
Tanda Tangan:
export declare class BlockSvg extends Block implements IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable, IFocusableNode
Memperluas: Block
Menerapkan: IBoundedElement, IContextMenu, ICopyable<BlockCopyData>, IDraggable, IDeletable, IFocusableNode
Konstruktor
| Konstruktor | Pengubah | Deskripsi |
|---|---|---|
| (constructor)(workspace, prototypeName, opt_id) | Membuat instance baru class BlockSvg |
Properti
| Properti | Pengubah | Jenis | Deskripsi |
|---|---|---|---|
| COLLAPSED_WARNING_ID |
|
(tidak dideklarasikan) | ID untuk memberikan peringatan "peringatan diciutkan". Memungkinkan kita menghapus peringatan "peringatan diciutkan" tanpa menghapus peringatan apa pun yang termasuk dalam blok. |
| customContextMenu? | (p1: Array<ContextMenuOption | LegacyContextMenuOption>) => void | (Opsional) | |
| decompose? | (p1: Workspace) => BlockSvg | (Opsional) | |
| height | angka | Tinggi blok ini, tidak termasuk blok pernyataan di atas atau di bawah. Tinggi dalam satuan ruang kerja. | |
| INLINE |
|
(tidak dideklarasikan) | Konstanta untuk mengidentifikasi baris yang akan dirender secara inline. Jangan bentrok dengan Blockly.inputTypes. |
| mutator | MutatorIcon | null | Ikon pengubah blok (jika ada). | |
| nextConnection | RenderedConnection | ||
| outputConnection | RenderedConnection | ||
| previousConnection | RenderedConnection | ||
| dirender | readonly |
(tidak dideklarasikan) | Apakah blok ini adalah BlockSVG? |
| saveConnections? | (rootBlock: BlockSvg) => void | (Opsional) Metode opsional yang menyimpan catatan blok yang terhubung ke blok ini sehingga dapat dipulihkan nanti setelah blok ini disusun ulang (dikonfigurasi ulang). Biasanya mencatat blok yang terhubung pada properti pada blok di flyout mutator, sehingga mengatur ulang blok komponen tersebut akan otomatis mengatur ulang blok yang terhubung yang sesuai pada blok ini setelah blok ini direkomposisi. Agar informasi koneksi yang disimpan selalu terbaru, MutatorIcon mengatur pemroses peristiwa untuk memanggil metode ini setiap kali flyout pengubah terbuka dan perubahan terjadi di ruang kerja blok ini. |
|
| style | BlockStyle | ||
| width | angka | Lebar blok ini, termasuk blok nilai yang terhubung. Lebar dalam satuan ruang kerja. | |
| ruang kerja | WorkspaceSvg |
Metode
| Metode | Pengubah | Deskripsi |
|---|---|---|
| addClass(className) | Tambahkan class CSS ke grup SVG blok ini. | |
| addIcon(icon) | ||
| addSelect() | Menambahkan efek "pilih" visual ke blok, tetapi tidak benar-benar memilihnya atau memicu peristiwa. | |
| appendInput(input) | ||
| bringToFront(blockOnly) | Pindahkan blok ini ke bagian depan ruang kerja yang terlihat. Tag |
|
| bumpNeighbours() | Menggeser blok yang tidak terhubung agar tidak sejajar. Dua blok yang sebenarnya tidak terhubung tidak boleh secara kebetulan sejajar di layar, karena hal itu akan membingungkan pengguna akhir. |
|
| calculateContextMenuLocation(e) | protected |
Mendapatkan lokasi untuk menampilkan menu konteks untuk blok ini. Gunakan lokasi klik jika blok diklik, atau lokasi berdasarkan kolom blok jika tidak. |
| canBeFocused() | Lihat IFocusableNode.canBeFocused. | |
| checkAndDelete() | Hapus blok dan sembunyikan sampah saat melakukannya. Blok tidak akan dihapus jika berada di flyout. Tindakan ini dipanggil dari menu konteks dan pintasan keyboard sebagai tindakan penghapusan penuh. Jika Anda menghapus blok dari ruang kerja dan tidak perlu melakukan pemeriksaan flyout, menangani pengelompokan peristiwa, atau menyembunyikan sampah, gunakan block.dispose() secara langsung. |
|
| dispose(healStack, animate) | Buang blok ini. | |
| disposeInternal() | Menghapus blok ini tanpa melakukan hal-hal yang diperlukan oleh blok atas. Misalnya, memicu efek UI, menghapus node, dll. | |
| drag(newLoc, e) | Menarik blok ke lokasi yang ditentukan. | |
| endDrag(e) | Mengakhiri tarikan pada blok. | |
| generateContextMenu(e) | protected |
Buat menu konteks untuk blok ini. |
| getBoundingRectangle() | Menampilkan koordinat kotak pembatas yang menjelaskan dimensi blok ini dan blok apa pun yang ditumpuk di bawahnya. Sistem koordinat: koordinat ruang kerja. | |
| getBoundingRectangleWithoutChildren() | Menampilkan koordinat kotak pembatas yang menjelaskan dimensi blok ini saja. Sistem koordinat: koordinat ruang kerja. | |
| getChildren(ordered) | Temukan semua blok yang langsung bertingkat di dalam blok ini. Mencakup input nilai dan pernyataan, serta pernyataan berikutnya. Mengecualikan koneksi apa pun di tab output atau pernyataan sebelumnya. Blok dapat diurutkan berdasarkan posisi secara opsional; dari atas ke bawah. | |
| getColour() | Mendapatkan warna blok. | |
| getColourSecondary() | Mendapatkan warna sekunder blok. | |
| getColourTertiary() | Mendapatkan warna tersier blok. | |
| getFocusableElement() | Lihat IFocusableNode.getFocusableElement. | |
| getFocusableTree() | Lihat IFocusableNode.getFocusableTree. | |
| getNextBlock() | Menampilkan blok pernyataan berikutnya yang terhubung langsung ke blok ini. | |
| getPreviousBlock() | Menampilkan blok yang terhubung ke koneksi sebelumnya. | |
| getRelativeToSurfaceXY() | Menampilkan koordinat sudut kiri atas blok ini relatif terhadap origin platform gambar (0,0), dalam satuan ruang kerja. Jika blok berada di ruang kerja, (0, 0) adalah asal sistem koordinat ruang kerja. Hal ini tidak berubah dengan skala ruang kerja. | |
| getStyle() | Menampilkan objek BlockStyle yang digunakan untuk menata gaya blok ini. | |
| getSvgRoot() | Menampilkan node root SVG atau null jika tidak ada. | |
| initSvg() | Buat dan lakukan inisialisasi representasi SVG blok. Dapat dipanggil lebih dari sekali. | |
| isMovable() | Menampilkan apakah blok ini dapat dipindahkan atau tidak. | |
| jsonInit(json) | ||
| markDirty() | Memberi tahu setiap input di blok ini untuk menandai kolomnya sebagai kotor. Kolom kotor adalah kolom yang perlu dirender ulang. | |
| moveBy(dx, dy, reason) | Memindahkan blok dengan offset relatif. | |
| moveNumberedInputBefore(inputIndex, refIndex) | Pindahkan input bernomor ke lokasi lain di blok ini. | |
| moveTo(xy, reason) | Memindahkan blok ke posisi. | |
| onNodeBlur() | Lihat IFocusableNode.onNodeBlur. | |
| onNodeFocus() | Lihat IFocusableNode.onNodeFocus. | |
| removeClass(className) | Menghapus class CSS dari grup SVG blok ini. | |
| removeIcon(type) | ||
| removeInput(name, opt_quiet) | Menghapus input dari blok ini. | |
| removeSelect() | Menghapus efek "pilih" visual dari blok, tetapi tidak benar-benar membatalkan pilihannya atau memicu peristiwa. | |
| render() | Segera menata dan mengatur ulang blok berdasarkan konten dan setelannya. | |
| revertDrag() | Memindahkan blok kembali ke posisi awal saat ditarik. | |
| scheduleSnapAndBump() | Snap to grid, lalu dorong blok tetangga ke luar di akhir render berikutnya. | |
| select() | Memilih blok ini. Menyoroti blok secara visual. | |
| setCollapsed(collapsed) | Menetapkan apakah blok diciutkan atau tidak. | |
| setColour(colour) | Mengubah warna blok. | |
| setDeletable(deletable) | Menambahkan class blocklyNotDeletable saat blok tidak dapat dihapus Atau menghapus class saat blok dapat dihapus | |
| setDisabledReason(disabled, reason) | Tambahkan atau hapus alasan mengapa pemblokiran mungkin dinonaktifkan. Jika ada alasan untuk menonaktifkan blok, blok itu sendiri akan dianggap dinonaktifkan. Blokir dapat dinonaktifkan karena beberapa alasan independen secara bersamaan, seperti saat pengguna menonaktifkannya secara manual, atau blokir tidak valid. | |
| setDragStrategy(dragStrategy) | Menetapkan strategi tarik untuk blok ini. | |
| setEditable(editable) | Tetapkan apakah blok ini dapat diedit atau tidak. | |
| setHighlighted(highlighted) | Menetapkan apakah blok disorot atau tidak. Penandaan blok sering digunakan untuk menandai blok secara visual yang saat ini sedang dieksekusi. | |
| setInputsInline(newBoolean) | Tetapkan apakah input nilai diatur secara horizontal atau vertikal. | |
| setMovable(movable) | Menetapkan apakah blok ini dapat dipindahkan atau tidak. | |
| setMutator(mutator) | Berikan dialog pengubah ke blok ini. | |
| setNextStatement(newBoolean, opt_check) | Menetapkan apakah blok lain dapat dirantai ke bagian bawah blok ini. | |
| setOutput(newBoolean, opt_check) | Tetapkan apakah blok ini menampilkan nilai. | |
| setPreviousStatement(newBoolean, opt_check) | Tetapkan apakah blok ini dapat dirantai ke bagian bawah blok lain. | |
| setStyle(blockStyleName) | Menetapkan nilai gaya dan warna blok. | |
| setWarningText(text, id) | Tetapkan teks peringatan blok ini. | |
| snapToGrid() | Snap blok ini ke titik petak terdekat. | |
| startDrag(e) | Memulai tarik pada blok. | |
| toCopyData() | Mengenkode blok untuk disalin. | |
| toFlyoutInfo() | Menampilkan representasi blok ini yang dapat ditampilkan di flyout. | |
| translate(x, y) | Mengubah blok dengan menetapkan terjemahan pada atribut transformasi SVG blok. | |
| unselect() | Membatalkan pilihan blok ini. Menghapus sorotan blok secara visual. |