Blockly | Google for Developers

Blockly akan dipindahkan ke Raspberry Pi Foundation pada 10 November 2025. Baca blog dan FAQ.

Halaman ini diterjemahkan oleh Cloud Translation API.

Class Toolbox

Class untuk Toolbox. Membuat DOM toolbox.

Tanda Tangan:

export declare class Toolbox extends DeleteArea implements IAutoHideable, IKeyboardAccessible, IStyleable, IToolbox, IFocusableNode

Memperluas: DeleteArea

Implements: IAutoHideable, IKeyboardAccessible, IStyleable, IToolbox, IFocusableNode

Konstruktor

Konstruktor	Pengubah	Deskripsi
(constructor)(workspace)		Membuat instance baru class `Toolbox`

Properti

Properti	Pengubah	Jenis	Deskripsi
boundEvents_	`protected`	browserEvents.Data[]	Array yang menyimpan info yang diperlukan untuk melepaskan binding handler peristiwa. Digunakan untuk membuang. Contoh: [[node, name, func], [node, name, func]].
isi	`protected`	Map<string, IToolboxItem>	Memetakan dari ID ke item toolbox yang sesuai.
contentsDiv_	`protected`	HTMLDivElement \| null	Penampung HTML untuk konten toolbox.
height_	`protected`	angka	Tinggi kotak alat.
HtmlDiv		HTMLDivElement \| null	Penampung HTML untuk toolbox.
id		string	ID unik untuk komponen ini yang digunakan untuk mendaftar ke ComponentManager.
isVisible_	`protected`	boolean	Apakah Toolbox terlihat.
previouslySelectedItem_	`protected`	ISelectableToolboxItem \| null	Item yang dipilih sebelumnya.
RTL		boolean
selectedItem_	`protected`	ISelectableToolboxItem \| null	Item yang saat ini dipilih.
toolboxDef_	`protected`	toolbox.ToolboxInfo
toolboxPosition		toolbox.Position
width_	`protected`	angka	Lebar toolbox.
workspace_	`protected` `readonly`	WorkspaceSvg	Ruang kerja tempat toolbox ini berada.

Metode

Metode	Pengubah	Deskripsi
addToolboxItem_(toolboxItem)	`protected`	Menambahkan item ke toolbox.
attachEvents_(container, contentsContainer)	`protected`	Menambahkan pemroses peristiwa ke div penampung toolbox.
autoHide(onlyClosePopups)		Menyembunyikan komponen. Dipanggil di WorkspaceSvg.hideChaff.
canBeFocused()		Lihat IFocusableNode.canBeFocused.
clearSelection()		Membatalkan penyorotan item yang sebelumnya dipilih.
createContainer_()	`protected`	Membuat div penampung untuk kotak alat.
createContentsContainer_()	`protected`	Membuat penampung untuk semua konten di toolbox.
createDom_(workspace)	`protected`	Membuat DOM untuk kotak peralatan.
createFlyout_()	`protected`	Membuat flyout berdasarkan tata letak toolbox.
deselectItem_(item)	`protected`	Membatalkan pilihan item tertentu, menandainya sebagai tidak dipilih, dan memperbarui status aria.
dispose()		Membuang toolbox ini.
getClientRect()		Menampilkan persegi panjang pembatas area target penarikan dalam satuan piksel relatif terhadap area tampilan.
getFlyout()		Mendapatkan flyout kotak alat.
getFocusableElement()		Lihat IFocusableNode.getFocusableElement.
getFocusableTree()		Lihat IFocusableNode.getFocusableTree.
getHeight()		Mendapatkan tinggi kotak alat.
getNestedTrees()		Lihat IFocusableTree.getNestedTrees.
getPreviouslySelectedItem()		Mendapatkan item yang dipilih sebelumnya.
getRestoredFocusableNode(previousNode)		Lihat IFocusableTree.getRestoredFocusableNode.
getRootFocusableNode()		Lihat IFocusableTree.getRootFocusableNode.
getSelectedItem()		Mendapatkan item yang dipilih.
getToolboxItemById(id)		Mendapatkan item toolbox dengan ID yang diberikan.
getToolboxItems()		Mendapatkan item di toolbox.
getWidth()		Mendapatkan lebar toolbox.
getWorkspace()		Mendapatkan ruang kerja untuk toolbox.
init()		Menginisialisasi kotak peralatan
isHorizontal()		Mendapatkan apakah toolbox horizontal atau tidak.
lookUpFocusableNode(id)		Lihat IFocusableTree.lookUpFocusableNode.
onClick_(e)	`protected`	Menangani peristiwa klik saat toolbox atau item toolbox diklik.
onDragEnter(_dragElement)		Menangani saat kursor dengan blok atau balon memasuki target penarikan ini.
onDragExit(_dragElement)		Menangani saat kursor dengan blok atau balon keluar dari target penarikan ini.
onDrop(_dragElement)		Menangani saat blok atau balon dilepas pada komponen ini. Tidak boleh menangani penghapusan di sini.
onKeyDown_(e)	`protected`	Menangani peristiwa tombol ditekan untuk kotak alat.
onNodeBlur()		Lihat IFocusableNode.onNodeBlur.
onNodeFocus()		Lihat IFocusableNode.onNodeFocus.
onShortcut(_shortcut)		Menangani pintasan keyboard tertentu.
onTreeBlur(nextTree)		Lihat IFocusableTree.onTreeBlur.
onTreeFocus(node, _previousTree)		Lihat IFocusableTree.onTreeFocus.
position()		Memosisikan kotak peralatan berdasarkan apakah kotak peralatan tersebut horizontal dan apakah ruang kerja berada di rtl.
refreshSelection()		Memperbarui konten flyout tanpa menutupnya. Harus digunakan sebagai respons terhadap perubahan di salah satu kategori dinamis, seperti variabel atau prosedur.
renderContents_(toolboxDef)	`protected`	Menambahkan semua item kotak alat ke kotak alat.
selectItem_(oldItem, newItem)	`protected`	Memilih item tertentu, menandainya sebagai dipilih, dan memperbarui status aria.
selectItemByPosition(position)		Memilih item toolbox berdasarkan posisinya dalam daftar item toolbox.
setSelectedItem(newItem)		Menetapkan item yang diberikan sebagai dipilih. Tidak ada operasi jika item tidak dapat dipilih.
setVisible(isVisible)		Menampilkan atau menyembunyikan kotak alat.
shouldDeselectItem_(oldItem, newItem)	`protected`	Memutuskan apakah item lama harus dibatalkan pilihannya.
shouldSelectItem_(oldItem, newItem)	`protected`	Memutuskan apakah item baru harus dipilih.
updateCursorDeleteStyle_(addStyle)	`protected`	Menambahkan atau menghapus gaya CSS kursor di atas toolbox berdasarkan apakah blok atau balon di atasnya diharapkan dihapus jika dilepas (menggunakan properti this.wouldDelete_ internal).
updateFlyout_(oldItem, newItem)	`protected`	Memutuskan apakah akan menyembunyikan atau menampilkan flyout, bergantung pada item yang dipilih.
updateWouldDelete_(wouldDelete)	`protected`	Memperbarui status wouldDelete_ internal.
wouldDelete(element)		Menampilkan apakah blok atau balon yang diberikan akan dihapus jika dilepas di area ini. Metode ini harus memeriksa apakah elemen dapat dihapus dan selalu dipanggil sebelum onDragEnter/onDragOver/onDragExit.