Blokir kelas
Class untuk satu blok. Biasanya tidak dipanggil secara langsung, workspace.newBlock() lebih disarankan.
Tanda Tangan:
export declare class Block implements IASTNodeLocation
Menerapkan: IASTNodeLocation
Konstruktor
| Konstruktor | Pengubah | Deskripsi |
|---|---|---|
| (konstruktor)(ruang kerja, prototipeName, opt_id) | Membuat instance baru dari class Block |
Properti
| Properti | Pengubah | Jenis | Deskripsi |
|---|---|---|---|
| childBlocks_ | protected |
ini[] | |
| collapsed_ | protected |
boolean | |
| COLLAPSED_FIELD_NAME |
|
string | ID netral bahasa yang diberikan ke kolom yang diciutkan. |
| COLLAPSED_INPUT_NAME |
|
string | ID netral bahasa yang diberikan ke input yang diciutkan. |
| colour_ | protected |
string | Warna blok di '#RRGGBB' format font. |
| tulis? | (p1: Blokir) => kosong | (Opsional) Fungsi opsional yang mengonfigurasi ulang blok berdasarkan konten dialog mutator. | |
| contextMenu | boolean | ||
| data | rangkaian | null (kosong) | Data teks opsional yang bolak-balik antara blok dan XML. Tidak memiliki efek. Dapat digunakan oleh pihak ketiga untuk informasi meta. | |
| terurai? | (p1: Ruang Kerja) => Blokir | (Opsional) Fungsi opsional yang mengisi dialog mutator dengan komponen blok ini. | |
| hancurkan? | () => kosong | (Opsional) Metode opsional yang dipanggil selama pembuangan. | |
| membuang | protected |
boolean | Apakah blok yang aktif saat ini sedang dalam proses dibuang? |
| domToMutation? | (p1: Elemen) => kosong | (Opsional) Metode deserialisasi opsional untuk menentukan cara melakukan deserialisasi status mutasi dari XML. Hal ini harus ditambah dengan penentuan mutationToDom. |
|
| getDeveloperVariables? | () => {i>string<i}[] | (Opsional) Properti opsional untuk mendeklarasikan variabel developer. Menampilkan daftar nama variabel untuk digunakan oleh generator. Variabel developer tidak pernah ditampilkan kepada pengguna, tetapi dideklarasikan sebagai variabel global dalam kode yang dihasilkan. | |
| topi? | string | (Opsional) Nama jenis topi. | |
| helpUrl | rangkaian | {i>Function <i}(Fungsi) | null (kosong) | String untuk bantuan pemblokiran, atau fungsi yang menampilkan URL. Null tanpa bantuan. | |
| ikon | IIcon[] | ||
| id | string | ||
| init? | () => kosong | (Opsional) Metode opsional yang dipanggil selama inisialisasi. | |
| inputList | Masukan[] | ||
| inputsInline? | boolean | (Opsional) | |
| inputsInlineDefault? | boolean | (Opsional) | |
| isInFlyout | boolean | ||
| isInMutator | boolean | ||
| isInsertionMarker_ | protected |
boolean | Benar jika blok ini adalah penanda penyisipan. |
| loadExtraState? | (p1: setiap) => kosong | (Opsional) Metode serialisasi opsional untuk menentukan cara melakukan deserialisasi status tambahan blok (misalnya status mutasi) dari sesuatu yang kompatibel dengan JSON. Hal ini harus ditambah dengan penentuan saveExtraState. |
|
| mutationToDom? | (...p1: setiap[]) => Elemen | (Opsional) Metode serialisasi opsional untuk menentukan cara serialisasi status mutasi ke XML. Hal ini harus ditambah dengan penentuan domToMutation. |
|
| nextConnection | Koneksi | null (kosong) | ||
| di-ganti? | ((p1: Abstrak) => void) | null (kosong) | (Opsional) Metode callback opsional yang akan digunakan setiap kali ruang kerja induk blok berubah. Fungsi ini biasanya hanya dipanggil dari konstruktor, fungsi penginisialisasi jenis blok, atau fungsi penginisialisasi ekstensi. | |
| outputConnection | Koneksi | null (kosong) | ||
| outputShape_ | protected |
angka | null (kosong) | |
| parentBlock_ | protected |
ini | null (kosong) | |
| previousConnection | Koneksi | null (kosong) | ||
| dirender | readonly |
boolean | Apakah ini memblokir BlockSVG? |
| RTL | boolean | ||
| saveExtraState? | (doFullSerialization?: boolean) => setiap | (Opsional) Metode serialisasi opsional untuk menentukan cara menserialisasi status tambahan blok (misalnya status mutasi) ke sesuatu yang kompatibel dengan JSON. Hal ini harus ditambah dengan penentuan loadExtraState. |
|
| styleName_ | protected |
string | Nama gaya blok. |
| suppressPrefixSuffix | boolean | null (kosong) | Properti opsional untuk menyembunyikan penambahan CHANGEMENT_PREFIX dan WHEREMENT_SUFFIX ke kode yang dihasilkan. | |
| tooltip | Tooltip.TipInfo | ||
| jenis | string | ||
| ruang kerja | Ruang kerja |
Metode
| Metode | Pengubah | Deskripsi |
|---|---|---|
| addIcon(icon) | Menambahkan ikon yang diberikan ke blok. | |
| allInputsFilled(opt_shadowBlocksAreFilled) | Secara rekursif memeriksa apakah semua input pernyataan dan nilai diisi dengan blok. Juga memeriksa semua blok pernyataan berikut dalam stack ini. | |
| appendDummyInput(name) | Menambahkan baris input contoh. | |
| appendEndRowInput(name) | Menambahkan input yang mengakhiri baris. | |
| appendInput(input) | Menambahkan baris input yang diberikan. Memungkinkan input kustom ditambahkan ke blok. |
|
| appendStatementInput(name) | Menambahkan baris input pernyataan. | |
| appendValueInput(name) | Menambahkan baris input nilai. | |
| bumpNeighbours() | Tubruk blok yang tidak terhubung hingga tidak sejajar. Dua blok yang tidak benar-benar terhubung seharusnya tidak kebetulan sejajar di layar. | |
| dispose(healStack) | Buang blok ini. | |
| disposeInternal() | protected |
Buang blok ini tanpa melakukan hal-hal yang diperlukan oleh blok atas. Mis. tidak memicu peristiwa, mencabut blok, dll. |
| doInit_() | protected |
Memanggil fungsi init() dan menangani pengaktifan peristiwa terkait, dll. |
| getChildren(ordered) | Temukan semua blok yang disusun bertingkat langsung di dalam blok ini. Menyertakan input nilai dan pernyataan, serta pernyataan berikut. Tidak mencakup koneksi apa pun pada tab output atau pernyataan sebelumnya. Blok diurutkan secara opsional berdasarkan posisi; atas ke bawah. | |
| getColour() | Mendapatkan warna blok. | |
| getCommentText() | Menampilkan komentar pada blok ini (atau null jika tidak ada komentar). | |
| getDescendants(ordered) | Temukan semua blok yang disusun bertingkat secara langsung atau tidak langsung di dalam blok ini. Menyertakan blok ini dalam daftar. Menyertakan input nilai dan pernyataan, serta pernyataan berikut. Tidak mencakup koneksi apa pun di tab output atau pernyataan sebelumnya. Blok diurutkan secara opsional berdasarkan posisi; atas ke bawah. | |
| getDisabledReasons() | Dapatkan serangkaian alasan pemblokiran saat ini dinonaktifkan, jika ada. Jika blok diaktifkan, kumpulan ini akan kosong. | |
| getField(name) | Menampilkan kolom bernama dari blok. | |
| getFieldValue(name) | Menampilkan nilai netral bahasa dari kolom yang ditentukan. | |
| getHue() | Mendapatkan nilai hue HSV dari blok. Null jika hue tidak ditetapkan. | |
| getIcon(type) | ||
| getIcons() | ||
| getInheritedDisabled() | Mengetahui apakah pemblokiran dinonaktifkan atau tidak karena orang tua. Properti yang dinonaktifkan dari blok itu sendiri tidak dipertimbangkan. | |
| getInput(name) | Mengambil objek input yang telah diberi nama. | |
| getInputsInline() | Mendapatkan apakah input nilai disusun secara horizontal atau vertikal. | |
| getInputTargetBlock(name) | Mengambil blok yang dilampirkan ke input bernama. | |
| getInputWithBlock(block) | Menampilkan input yang terhubung ke blok yang ditentukan. | |
| getNextBlock() | Menampilkan blok pernyataan berikutnya yang langsung terhubung ke blok ini. | |
| getOutputShape() | Mendapatkan bentuk output blok. | |
| getParent() | Tampilkan blok induk atau null jika blok ini berada di level teratas. Blok induk adalah blok yang terhubung ke koneksi sebelumnya (untuk blok pernyataan) atau blok yang terhubung ke koneksi output (untuk blok nilai). | |
| getPreviousBlock() | Menampilkan blok yang terhubung ke koneksi sebelumnya. | |
| getRelativeToSurfaceXY() | Menampilkan koordinat sudut kiri atas blok ini relatif terhadap asal permukaan gambar (0,0), dalam unit ruang kerja. | |
| getRootBlock() | Menampilkan blok paling atas dalam hierarki blok ini. Ini akan kembali dengan sendirinya jika blok ini berada pada tingkat teratas. | |
| getStyleName() | Dapatkan nama gaya blok. | |
| getSurroundParent() | Menampilkan blok induk yang mengelilingi blok saat ini, atau null jika blok ini tidak memiliki blok di sekitarnya. Blok induk mungkin hanya berupa pernyataan sebelumnya, sedangkan blok di sekitarnya adalah pernyataan if, loop sementara, dll. | |
| getTooltip() | Menampilkan teks tooltip untuk blok ini. | |
| getVars() | Menampilkan semua variabel yang dirujuk oleh blok ini. | |
| hasDisabledReason(reason) | Ketahui apakah pemblokiran saat ini dinonaktifkan karena alasan yang diberikan. | |
| hasIcon(type) | ||
| initModel() | Panggil initModel pada semua kolom di blok. Dapat dipanggil lebih dari sekali. InitModel atau initSvg harus dipanggil setelah membuat blok dan sebelum interaksi pertama dengannya. Interaksi mencakup tindakan UI (misalnya, mengklik dan menarik) dan peristiwa pengaktifan (misalnya, membuat, menghapus, dan mengubah). | |
| isCollapsed() | Ketahui apakah blok diciutkan atau tidak. | |
| isDeletable() | Ketahui apakah blok ini dapat dihapus atau tidak. | |
| isDisposed() | Menampilkan jika pemblokiran ini telah dibuang / dihapus. | |
| isDuplicatable() | Mengetahui apakah blok dapat diduplikasi atau tidak. Jika menduplikasi blok ini dan turunannya akan menempatkan blok ini di atas kapasitas ruang kerja, blok ini tidak dapat diduplikasi. Jika menduplikasi blok ini dan turunannya akan menempatkan jenis apa pun di atas maxInstances-nya, blok ini tidak dapat diduplikasi. | |
| isEnabled() | Ketahui apakah pemblokiran ini diaktifkan atau tidak. Pemblokiran dianggap aktif jika tidak ada alasan untuk penonaktifan tersebut. Pemblokiran mungkin tetap dinonaktifkan karena alasan lain meskipun pengguna mencoba mengaktifkannya secara manual, seperti saat pemblokiran berada di lokasi yang tidak valid. | |
| isInsertionMarker() | Ketahui apakah blok ini merupakan blok penanda penyisipan atau bukan. | |
| isOwnDeletable() | Tampilkan apakah properti yang dapat dihapus dari blok ini benar atau salah. | |
| isOwnEditable() | Tampilkan apakah properti yang dapat diedit untuk blok ini benar atau salah. | |
| isShadow() | Ketahui apakah blok ini merupakan blok bayangan atau bukan. | |
| jsonInit(json) | Lakukan inisialisasi blok ini menggunakan deskripsi JSON lintas platform yang sesuai untuk internasionalisasi. | |
| mixin(mixinObj, opt_disableCheck) | Tambahkan kunci/nilai dari mixinObj ke objek blok ini. Secara default, metode ini akan memeriksa bahwa kunci dalam mixinObj tidak akan menimpa nilai yang ada di blok, termasuk nilai prototipe. Hal ini memberikan beberapa asuransi terhadap ketidaksesuaian mixin / ekstensi dengan fitur pemblokiran di masa mendatang. Pemeriksaan ini dapat dinonaktifkan dengan meneruskan true sebagai argumen kedua. | |
| moveBy(dx, dy, reason) | Memindahkan blok dengan offset relatif. | |
| moveInputBefore(name, refName) | Memindahkan input bernama ke lokasi lain di blok ini. | |
| moveNumberedInputBefore(inputIndex, refIndex) | Memindahkan input bernomor ke lokasi lain di blok ini. | |
| removeIcon(type) | Menghapus ikon yang getType-nya cocok dengan jenis iconType yang diberikan dari blok. | |
| removeInput(name, opt_quiet) | Hapus input dari blok ini. | |
| renameVarById(oldId, newId) | Notifikasi bahwa variabel diganti namanya. Jika ID cocok dengan salah satu variabel blok ini, ganti nama ID tersebut. | |
| setCollapsed(collapsed) | Menyetel apakah blok diciutkan atau tidak. | |
| setColour(colour) | Mengubah warna blok. | |
| setCommentText(text) | Setel teks komentar blok ini. | |
| setDeletable(deletable) | Tetapkan apakah blok ini dapat dihapus atau tidak. | |
| setDisabledReason(disabled, reason) | Tambahkan atau hapus alasan mengapa pemblokiran mungkin dinonaktifkan. Jika suatu pemblokiran memiliki alasan untuk dinonaktifkan, pemblokiran itu sendiri akan dianggap dinonaktifkan. Pemblokiran dapat dinonaktifkan karena berbagai alasan yang independen secara bersamaan, seperti ketika pengguna menonaktifkannya secara manual, atau pemblokiran tidak valid. | |
| setEditable(editable) | Tetapkan apakah blok ini dapat diedit atau tidak. | |
| setEnabled(enabled) | ||
| setFieldValue(newValue, name) | Menetapkan nilai kolom yang diberikan untuk blok ini. | |
| setHelpUrl(url) | Setel URL halaman bantuan pemblokiran ini. | |
| setInputsInline(newBoolean) | Tetapkan apakah input nilai disusun secara horizontal atau vertikal. | |
| setMovable(movable) | Setel apakah blok ini dapat dipindahkan atau tidak. | |
| setMutator(_mutator) | Berikan dialog mutator untuk blok ini. | |
| setNextStatement(newBoolean, opt_check) | Tetapkan apakah blok lain dapat terhubung ke bagian bawah blok ini. | |
| setOnChange(onchangeFn) | Menetapkan fungsi callback yang akan digunakan setiap kali ruang kerja induk blok berubah, menggantikan pengendali onchange sebelumnya. Fungsi ini biasanya hanya dipanggil dari konstruktor, fungsi penginisialisasi jenis blok, atau fungsi penginisialisasi ekstensi. | |
| setOutput(newBoolean, opt_check) | Tetapkan apakah blok ini menampilkan nilai. | |
| setOutputShape(outputShape) | Menyetel bentuk output blok. | |
| setPreviousStatement(newBoolean, opt_check) | Tetapkan apakah blok ini dapat berantai ke bagian bawah blok lain. | |
| setStyle(blockStyleName) | Mengatur nilai gaya dan warna blok. | |
| setTooltip(newTip) | Menetapkan tooltip untuk blok ini. | |
| setWarningText(_text, _opt_id) | Setel teks peringatan pemblokiran ini. | |
| toDevString() | Metode ini menampilkan string yang menjelaskan Pemblokiran ini dalam istilah developer (nama dan ID jenis; hanya dalam bahasa Inggris). Ditujukan untuk digunakan pada log dan error konsol. Jika Anda memerlukan string yang menggunakan bahasa asli pengguna (termasuk teks blok, nilai kolom, dan blok turunan), gunakan [toString()]. |
|
| toString(opt_maxLength, opt_emptyToken) | Buat representasi teks yang dapat dibaca manusia untuk blok ini dan turunannya. | |
| unplug(opt_healStack) | Cabut blok ini dari blok di atasnya. Jika blok ini berupa pernyataan, hubungkan kembali blok di bawah dengan blok di atas. |