Blockly | Google for Developers

Halaman ini diterjemahkan oleh Cloud Translation API.

Blokir kelas

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

Tanda Tangan:

export declare class Block implements IASTNodeLocation, IDeletable

Penerapan: IASTNodeLocation, IDeletable

Konstruktor

Konstruktor	Pengubah	Deskripsi
(konstruktor)(workspace, prototypeName, opt_id)		Membuat instance baru dari class `Block`

Properti

Properti	Pengubah	Jenis	Deskripsi
childBlocks_	`protected`	ini[]
collapsed_	`protected`	boolean
COLLAPSED_FIELD_NAME	`static` `readonly`	string	ID bahasa netral 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?		(p1: Blokir) => void	(Opsional) Fungsi opsional yang mengonfigurasi ulang blok berdasarkan konten dialog mutator.
contextMenu		boolean
data		string \| null	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.
destroy?		() => kosong	(Opsional) Metode opsional yang dipanggil selama pembuangan.
domToMutation?		(p1: Elemen) => void	(Opsional) Metode deserialisasi opsional untuk menentukan cara melakukan deserialisasi status mutasi dari XML. Hal ini harus disertai dengan penentuan `mutationToDom`.
getDeveloperVariables?		() => string[]	(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		string \| Function \| null	String untuk bantuan blok, atau fungsi yang menampilkan URL. Null jika tidak ada 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: apa saja) => void	(Opsional) Metode serialisasi opsional untuk menentukan cara melakukan deserialisasi status tambahan blok (misalnya status mutasi) dari sesuatu yang kompatibel dengan JSON. Hal ini harus disertai dengan penentuan `saveExtraState`.
mutationToDom?		(...p1: any[]) => Elemen	(Opsional) Metode serialisasi opsional untuk menentukan cara melakukan serialisasi status mutasi ke XML. Hal ini harus disertai dengan penentuan `domToMutation`.
nextConnection		Koneksi \| null
terus menerus?		((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`	nomor \| nol
parentBlock_	`protected`	ini \| null
previousConnection		Koneksi \| null
dirender		boolean \| null
RTL		boolean
saveExtraState?		(doFullSerialization?: boolean) => apa saja	(Opsional) Metode serialisasi opsional untuk menentukan cara melakukan serialisasi status tambahan blok (misalnya status mutasi) ke sesuatu yang kompatibel dengan JSON. Hal ini harus disertai dengan penentuan `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 ditentukan ke blok.
allInputsFilled(opt_shadowBlocksAreFilled)		Memeriksa secara rekursif apakah semua input pernyataan dan nilai diisi dengan blok. Juga periksa semua blok pernyataan berikut dalam tumpukan ini.
appendDummyInput(name)		Menambahkan baris input contoh.
appendEndRowInput(name)		Menambahkan input yang mengakhiri baris.
appendInput(input)		Menambahkan baris input yang ditentukan. Memungkinkan input kustom ditambahkan ke blok.
appendStatementInput(name)		Menambahkan baris input pernyataan.
appendValueInput(name)		Menambahkan baris input nilai.
bumpNeighbours()		Dorong blok yang tidak terhubung sehingga keluar dari sejajar. Dua blok yang tidak benar-benar terhubung tidak boleh sejajar di layar secara kebetulan.
buang(healStack)		Buang blok ini.
disposeInternal()	`protected`	Membuang blok ini tanpa melakukan hal-hal yang diperlukan oleh blok atas. Misalnya, tidak menyalakan peristiwa, mencabut blok, dll.
doInit_()	`protected`	Memanggil fungsi init() dan menangani pengaktifan peristiwa terkait, dll.
getChildren(ordered)		Temukan semua blok yang bersarang langsung di dalam blok ini. Menyertakan input nilai dan pernyataan, serta pernyataan berikut. Tidak termasuk koneksi apa pun pada tab output atau pernyataan sebelumnya. Blok diurutkan secara opsional berdasarkan posisi; atas ke bawah.
getColour()		Ketahui warna blok.
getCommentText()		Menampilkan komentar pada blok ini (atau null jika tidak ada komentar).
getDescendants(ordered)		Temukan semua blok yang bertingkat secara langsung atau tidak langsung di dalam blok ini. Menyertakan blok ini dalam daftar. Menyertakan input nilai dan pernyataan, serta pernyataan berikut. Tidak termasuk koneksi apa pun pada tab output atau pernyataan sebelumnya. Blok diurutkan secara opsional berdasarkan posisi; atas ke bawah.
getField(name)		Menampilkan kolom bernama dari blok.
getFieldValue(name)		Menampilkan nilai netral bahasa untuk kolom yang diberikan.
getHue()		Mendapatkan nilai hue HSV dari sebuah blok. Null jika hue tidak ditetapkan.
getIcon(type)
getIcons()
getInheritedDisabled()		Ketahui apakah pemblokiran dinonaktifkan atau bukan karena orang tua. Properti yang dinonaktifkan milik blok tidak dipertimbangkan.
getInput(name)		Mengambil objek input bernama.
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 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 asal permukaan gambar (0,0), dalam unit ruang kerja.
getRootBlock()		Menampilkan blok paling atas dalam hierarki blok ini. Tindakan ini akan menampilkan dirinya sendiri jika blok ini berada di level teratas.
getStyleName()		Dapatkan nama gaya blok.
getSurroundParent()		Return the parent block that surrounds the current block, or null if this block has no surrounding block. Blok induk mungkin hanya merupakan 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.
hasIcon(type)
initModel()		Panggil initModel di semua kolom yang ada dalam 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 mengaktifkan peristiwa (misalnya membuat, menghapus, dan mengubah).
isCollapsed()		Mengetahui apakah blok diciutkan atau tidak.
isDeletable()		Ketahui apakah blok ini dapat dihapus atau tidak.
isDisposed()		Menampilkan jika blok ini telah dibuang / dihapus.
isDuplicatable()		Ketahui apakah blok dapat digandakan atau tidak. Jika blok ini diduplikasi dan turunannya akan membuat blok ini melebihi kapasitas ruang kerja, blok ini tidak dapat digandakan. Jika menduplikasi blok ini dan turunan akan menempatkan jenis apa pun di atas maxInstances-nya, blok ini tidak dapat digandakan.
isEnabled()		Ketahui apakah pemblokiran ini diaktifkan atau tidak.
isInsertionMarker()		Ketahui apakah blok ini merupakan blok penanda penyisipan atau bukan.
isOwnDeletable()		Menampilkan apakah properti yang dapat dihapus milik blok ini benar atau salah.
isOwnEditable()		Menampilkan apakah properti yang dapat diedit dari 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 cocok 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 asuransi terhadap ketidaksesuaian 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)		Memindahkan input bernama ke lokasi lain di blok ini.
moveNumberedInputBefore(inputIndex, refIndex)		Memindahkan input bernomor ke lokasi yang berbeda 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 nama variabel diganti. 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)		Setel teks komentar blok ini.
setDeletable(deletable)		Tetapkan apakah blok ini dapat dihapus atau tidak.
setEditable(editable)		Tetapkan apakah blok ini dapat diedit atau tidak.
setEnabled(enabled)		Menetapkan apakah pemblokiran diaktifkan atau tidak.
setFieldValue(newValue, name)		Menetapkan nilai kolom yang diberikan untuk blok ini.
setHelpUrl(url)		Setel URL halaman bantuan blok ini.
setInputsInline(newBoolean)		Menyetel apakah input nilai disusun secara horizontal atau vertikal.
setMovable(movable)		Tetapkan apakah blok ini dapat dipindahkan atau tidak.
setMutator(_mutator)		Berikan dialog mutator untuk blok ini.
setNextStatement(newBoolean, opt_check)		Setel apakah blok lain dapat berantai di bagian bawah blok ini.
setOnChange(onchangeFn)		Menetapkan fungsi callback yang akan digunakan setiap kali ruang kerja induk blok berubah, yang menggantikan pengendali onchange sebelumnya. Ini biasanya hanya dipanggil dari konstruktor, fungsi penginisialisasi jenis blok, atau fungsi penginisialisasi ekstensi.
setOutput(newBoolean, opt_check)		Menetapkan apakah blok ini menampilkan nilai.
setOutputShape(outputShape)		Tetapkan bentuk output blok.
setPreviousStatement(newBoolean, opt_check)		Setel apakah blok ini dapat berantai ke bagian bawah blok lain.
setStyle(blockStyleName)		Menetapkan nilai gaya dan warna blok.
setTooltip(newTip)		Setel tooltip untuk pemblokiran ini.
setWarningText(_text, _opt_id)		Setel teks peringatan blok ini.
toDevString()		Metode ini menampilkan string yang menjelaskan Pemblokiran ini dalam istilah developer (nama jenis dan ID; hanya dalam bahasa Inggris). Ditujukan untuk digunakan dalam 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 turunan mana pun.
unplug(opt_healStack)		Cabut blok ini dari blok superiornya. Jika blok ini berupa pernyataan, Anda juga dapat menghubungkan kembali blok di bawahnya dengan blok di atasnya.