blockly > Block

Class blok

Class untuk satu blok. Biasanya tidak dipanggil secara langsung, workspace.newBlock() lebih disukai.

Tanda Tangan:

export declare class Block 

Konstruktor

Konstruktor	Pengubah	Deskripsi
(constructor)(workspace, prototypeName, opt_id)		Membuat instance baru class Block

Properti

Properti	Pengubah	Jenis	Deskripsi
childBlocks_	protected	this[]
collapsed_	protected	boolean
COLLAPSED_FIELD_NAME	static readonly	string	ID netral bahasa yang diberikan ke kolom yang diciutkan.
COLLAPSED_INPUT_NAME	static readonly	string	ID netral bahasa yang diberikan ke input yang diciutkan.
colour_	protected	string	Warna blok dalam format '#RRGGBB'.
compose?		(rootBlock: Block) => void	(Opsional) Metode opsional yang mengonfigurasi ulang blok berdasarkan konten dialog pengubah.
contextMenu		boolean
data		string | null	Data teks opsional yang melakukan perjalanan bolak-balik antara blok dan XML. Tidak memiliki efek. Dapat digunakan oleh pihak ketiga untuk informasi meta.
decompose?		(workspace: Workspace) => Block	(Opsional) Fungsi opsional yang mengisi flyout pengubah dengan blok yang mewakili konfigurasi blok ini.
destroy?		() => void	(Opsional) Metode opsional yang dipanggil selama pembuangan.
disposing	protected	boolean	Apakah blok saat ini sedang dalam proses dihapus?
domToMutation?		(p1: Element) => void	(Opsional) Metode deserialisasi opsional untuk menentukan cara mendeserialisasi status mutasi dari XML. Hal ini harus digabungkan dengan menentukan mutationToDom.
getDeveloperVariables?		() => string[]	(Opsional) Metode opsional untuk mendeklarasikan variabel developer, yang akan 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		string | (() => string) | null	String untuk bantuan blok, atau fungsi yang menampilkan URL. Null untuk tidak ada bantuan.
ikon		IIcon[]
id		string
init?		() => void	(Opsional) Metode opsional yang dipanggil selama inisialisasi.
inputList		Input[]
inputsInline?		boolean	(Opsional)
inputsInlineDefault?		boolean	(Opsional)
isInFlyout		boolean
isInMutator		boolean
isInsertionMarker_	protected	boolean	Benar jika blok ini adalah penanda penyisipan.
loadExtraState?		(p1: any) => void	(Opsional) Metode serialisasi opsional untuk menentukan cara mendeserialisasi status tambahan blok (misalnya status mutasi) dari sesuatu yang kompatibel dengan JSON. Hal ini harus digabungkan dengan menentukan saveExtraState.
mutationToDom?		(...p1: any[]) => Elemen	(Opsional) Metode serialisasi opsional untuk menentukan cara melakukan serialisasi status mutasi ke XML. Hal ini harus digabungkan dengan menentukan domToMutation.
nextConnection		Koneksi | null
onchange?		((p1: Abstract) => void) | null	(Opsional) Metode callback opsional yang akan digunakan setiap kali ruang kerja induk blok berubah. Ini biasanya hanya dipanggil dari konstruktor, fungsi penginisialisasi jenis blok, atau fungsi penginisialisasi ekstensi.
outputConnection		Koneksi | null
outputShape_	protected	number | null
parentBlock_	protected	this | null
previousConnection		Koneksi | null
dirender	readonly	boolean	Apakah blok ini adalah BlockSVG?
RTL		boolean
saveExtraState?		(doFullSerialization?: boolean) => any	(Opsional) Metode serialisasi opsional untuk menentukan cara melakukan serialisasi status tambahan blok (misalnya status mutasi) ke sesuatu yang kompatibel dengan JSON. Hal ini harus digabungkan dengan menentukan loadExtraState.
styleName_	protected	string	Nama gaya blok.
suppressPrefixSuffix		boolean | null	Properti opsional untuk menyembunyikan penambahan STATEMENT_PREFIX dan STATEMENT_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)		Memeriksa secara rekursif apakah semua input pernyataan dan nilai diisi dengan blok. Juga memeriksa semua blok pernyataan berikut dalam stack ini.
appendDummyInput(name)		Menambahkan baris input dummy.
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()		Menggeser blok yang tidak terhubung agar tidak sejajar. Dua blok yang sebenarnya tidak terhubung tidak boleh secara kebetulan sejajar di layar.
dispose(healStack)		Buang blok ini.
disposeInternal()	protected	Menghapus blok ini tanpa melakukan hal-hal yang diperlukan oleh blok atas. Misalnya, tidak memicu peristiwa, mencabut blok, dll.
doInit_()	protected	Memanggil fungsi init() dan menangani pengaktifan peristiwa terkait, dll.
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.
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. Mencakup input nilai dan pernyataan, serta pernyataan berikut. Tidak menyertakan koneksi apa pun di tab output atau pernyataan sebelumnya. Blok dapat diurutkan berdasarkan posisi secara opsional; dari atas ke bawah.
getDisabledReasons()		Mendapatkan serangkaian alasan mengapa blok saat ini dinonaktifkan, jika ada. Jika pemblokiran diaktifkan, kumpulan ini akan kosong.
getField(name)		Menampilkan kolom bernama dari blok.
getFields()		Menampilkan generator yang menyediakan setiap kolom di blok. Generator yang dapat digunakan untuk melakukan iterasi pada kolom di blok.
getFieldValue(name)		Menampilkan nilai netral bahasa dari kolom yang diberikan.
getHue()		Mendapatkan nilai hue HSV blok. Null jika hue tidak ditetapkan.
getIcon(type)
getIcons()
getInheritedDisabled()		Mendapatkan apakah pemblokiran dinonaktifkan atau tidak karena orang tua. Properti dinonaktifkan milik blok tidak dipertimbangkan.
getInput(name)		Mengambil objek input yang dinamai.
getInputsInline()		Mendapatkan apakah input nilai disusun secara horizontal atau vertikal.
getInputTargetBlock(name)		Mengambil blok yang dilampirkan ke input yang telah diberi nama.
getInputWithBlock(block)		Menampilkan input yang terhubung ke blok yang ditentukan.
getNextBlock()		Menampilkan blok pernyataan berikutnya yang terhubung langsung ke blok ini.
getOutputShape()		Mendapatkan bentuk output blok.
getParent()		Menampilkan blok induk atau null jika blok ini berada di tingkat 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 origin platform gambar (0,0), dalam satuan ruang kerja.
getRootBlock()		Menampilkan blok paling atas dalam hierarki blok ini. Ini akan menampilkan dirinya sendiri jika blok ini berada di tingkat teratas.
getStyleName()		Mendapatkan 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 pernyataan sebelumnya, sedangkan blok di sekitarnya adalah pernyataan if, loop while, dll.
getTooltip()		Menampilkan teks tooltip untuk blok ini.
getVars()		Menampilkan semua variabel yang dirujuk oleh blok ini.
hasDisabledReason(reason)		Mendapatkan apakah blok saat ini dinonaktifkan karena alasan yang diberikan.
hasIcon(type)
initModel()		Panggil initModel di semua kolom pada blok. Dapat dipanggil lebih dari sekali. initModel atau initSvg harus dipanggil setelah membuat blok dan sebelum interaksi pertama dengan blok tersebut. Interaksi mencakup tindakan UI (misalnya, mengklik dan menarik) serta memicu peristiwa (misalnya, membuat, menghapus, dan mengubah).
isCollapsed()		Mendapatkan apakah blok diciutkan atau tidak.
isDeletable()		Mendapatkan apakah blok ini dapat dihapus atau tidak.
isDisposed()		Menampilkan apakah blok ini telah dihapus / dibuang.
isDuplicatable()		Mendapatkan 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()		Mendapatkan apakah blok ini diaktifkan atau tidak. Blok dianggap diaktifkan jika tidak ada alasan untuk menonaktifkannya. Blok masih dapat dinonaktifkan karena alasan lain meskipun pengguna mencoba mengaktifkannya secara manual, seperti saat blok berada di lokasi yang tidak valid.
isInsertionMarker()		Mendapatkan apakah blok ini adalah blok penanda penyisipan atau bukan.
isOwnDeletable()		Menampilkan apakah properti yang dapat dihapus dari blok ini benar atau salah.
isOwnEditable()		Menampilkan apakah properti yang dapat diedit milik blok ini bernilai benar (true) atau salah (false).
isShadow()		Mendapatkan apakah blok ini adalah blok bayangan atau bukan.
jsonInit(json)		Lakukan inisialisasi blok ini menggunakan deskripsi JSON lintas platform yang mendukung internasionalisasi.
mixin(mixinObj, opt_disableCheck)		Tambahkan kunci/nilai dari mixinObj ke objek blok ini. Secara default, metode ini akan memeriksa bahwa kunci di mixinObj tidak akan menimpa nilai yang ada di blok, termasuk nilai prototipe. Hal ini memberikan beberapa jaminan terhadap inkompatibilitas mixin / ekstensi dengan fitur blok 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)		Pindahkan input bernama ke lokasi lain di blok ini.
moveNumberedInputBefore(inputIndex, refIndex)		Pindahkan 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)		Menghapus input dari blok ini.
renameVarById(oldId, newId)		Notifikasi bahwa variabel sedang diganti namanya. Jika ID cocok dengan salah satu variabel blok ini, ganti namanya.
setCollapsed(collapsed)		Menetapkan apakah blok diciutkan atau tidak.
setColour(colour)		Mengubah warna blok.
setCommentText(text)		Tetapkan teks komentar blok ini.
setDeletable(deletable)		Menetapkan apakah blok ini dapat dihapus atau tidak.
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.
setEditable(editable)		Tetapkan apakah blok ini dapat diedit atau tidak.
setFieldValue(newValue, name)		Menetapkan nilai kolom yang diberikan untuk blok ini.
setHelpUrl(url)		Tetapkan URL halaman bantuan blok ini.
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.
setOnChange(onchangeFn)		Menetapkan fungsi callback yang akan digunakan setiap kali ruang kerja induk blok berubah, menggantikan pengendali onchange sebelumnya. 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)		Menetapkan bentuk output blok.
setPreviousStatement(newBoolean, opt_check)		Tetapkan apakah blok ini dapat dirantai ke bagian bawah blok lain.
setStyle(blockStyleName)		Menetapkan nilai gaya dan warna blok.
setTooltip(newTip)		Menetapkan tooltip untuk blok ini.
setWarningText(_text, _opt_id)		Tetapkan teks peringatan blok ini.
toDevString()		Metode ini menampilkan string yang menjelaskan Blok ini dalam istilah developer (nama dan ID jenis; hanya dalam bahasa Inggris). Dimaksudkan untuk digunakan dalam error dan log 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 dari blok ini dan turunannya.
unplug(opt_healStack)		Cabut blok ini dari blok superiornya. Jika blok ini adalah pernyataan, hubungkan kembali blok di bawah dengan blok di atas secara opsional.