Anda dapat membuat ruang kerja dan menyisipkannya ke dalam DOM dalam satu panggilan, atau hanya membuat ruang kerja.
Injeksi
Anda dapat membuat ruang kerja Blockly dan menyisipkannya ke DOM dengan panggilan ke
Blockly.inject(location, options). Argumen pertama memberi tahu Blockly tempat untuk
menyisipkan ruang kerja di DOM. Argumen kedua adalah objek yang berisi opsi konfigurasi.
Untuk mengetahui informasi selengkapnya, lihat Membuat ruang kerja.
Pembuatan langsung
Anda dapat membuat ruang kerja secara langsung dengan memanggil new Blockly.WorkspaceSvg(new
Blockly.Options(options)). Saat melakukan panggilan ini, pastikan untuk meneruskan opsi konfigurasi Anda dalam panggilan ke new Blockly.Options(options) -- konstruktor WorkspaceSvg tidak dapat menerima objek opsi konfigurasi Anda secara langsung.
Opsi konfigurasi
Objek konfigurasi menerapkan
Blockly.BlocklyOptions
dan memiliki opsi berikut. Perhatikan bahwa beberapa opsi ini mengubah nilai defaultnya berdasarkan apakah toolbox yang disediakan memiliki kategori atau tidak.
| Nama | Jenis | Deskripsi |
|---|---|---|
collapse
|
boolean | Apakah menu konteks blok menyertakan item untuk menciutkan atau meluaskan blok. Nilai defaultnya adalah true jika toolbox memiliki kategori, false jika tidak. |
comments
|
boolean | Apakah menu konteks pemblokiran menyertakan item untuk menambahkan atau menghapus komentar. Nilai defaultnya adalah true jika toolbox memiliki kategori,false jika tidak. |
css
|
boolean | Jika salah (false), jangan menyuntikkan CSS (CSS menjadi tanggung jawab dokumen). Default-nya adalah true. |
disable
|
boolean | Apakah menu konteks blok menyertakan item untuk menonaktifkan atau mengaktifkan blok. Nilai defaultnya adalah true jika toolbox memiliki kategori, false jika tidak. |
grid |
objek | Mengonfigurasi petak yang dapat digunakan untuk menyelaraskan blok. Lihat Petak. |
horizontalLayout
|
boolean | Jika kotak alat true horizontal, jika kotak alat false vertikal. Default-nya adalah false. |
maxBlocks
|
angka | Jumlah maksimum blok yang dapat dibuat. Berguna untuk
latihan siswa. Default-nya adalah Infinity. |
maxInstances
|
objek | Memetakan dari jenis blok ke jumlah maksimum blok dari jenis tersebut yang dapat dibuat. Jenis yang tidak dideklarasikan secara default adalah
Infinity. Contoh:
maxInstances: {'controls_if': 3, 'math_number': 42} |
maxTrashcanContents
|
angka | Jumlah maksimum item yang dihapus yang akan muncul di menu
pop-up tempat sampah. '0' menonaktifkan fitur tersebut. Nilai defaultnya adalah
'32'. |
media
|
string | Jalur dari halaman (atau frame) ke direktori media Blockly.
Nilai defaultnya adalah
'https://blockly-demo.appspot.com/static/media/'. Lihat
Folder media. |
modalInputs
|
boolean | Jika true menampilkan editor modal untuk kolom input teks dan subkelasnya saat berada di perangkat seluler, dan editor inline di desktop. Jika false menampilkan editor inline di desktop dan perangkat seluler. Default-nya adalah true. |
move
|
objek | Mengonfigurasi perilaku tentang cara pengguna dapat berpindah di ruang kerja. Lihat Pindahkan. |
oneBasedIndex
|
boolean | Jika operasi string dan daftar true harus diindeks dari 1,
jika false diindeks dari 0. Setelan defaultnya adalah true. |
plugins
|
objek | Objek yang memetakan nama jenis registri ke class pengganti atau nama terdaftar class pengganti. Lihat Menyisipkan class pengganti. |
readOnly
|
boolean | Jika true, cegah pengguna mengedit. Menyembunyikan
kotak alat dan tempat sampah. Nilai defaultnya adalah false. Lihat juga
setIsReadOnly dan
isReadOnly. |
renderer
|
string | Menentukan perender yang digunakan oleh blockly. Perender
yang telah dipaketkan mencakup 'geras' (default), 'thrasos', dan
'zelos' (perender seperti Scratch). Untuk mengetahui informasi tentang perender kustom, lihat Membuat perender kustom. |
rtl
|
boolean | Jika true, cerminkan editor (untuk lokalitas bahasa Arab atau Ibrani).
Lihat demo RTL. Default-nya adalah false. |
scrollbars
|
objek atau boolean | Menetapkan apakah ruang kerja memiliki scrollbar
vertikal atau horizontal. Mengambil objek dengan properti horizontal yang menentukan apakah scrolling horizontal diaktifkan dan properti vertical yang menentukan apakah scrolling vertikal diaktifkan. Jika boolean diteruskan, maka sama dengan
meneruskan objek dengan properti horizontal dan vertical
yang ditetapkan sebagai nilai tersebut. Nilai defaultnya adalah true jika toolbox memiliki kategori. |
sounds |
boolean | Jika false, akan menonaktifkan suara. Nilai defaultnya adalah true. |
theme
|
Tema | Secara default menggunakan tema klasik jika tidak ada tema yang disediakan. Lihat Tema. |
toolbox
|
string, XML atau JSON | Struktur hierarki kategori dan blok yang tersedia untuk pengguna. Lihat menentukan toolbox untuk mengetahui informasi selengkapnya. |
toolboxPosition
|
string | Jika kotak alat 'start' berada di atas (jika horizontal) atau di kiri (jika
vertikal dan LTR) atau di kanan (jika vertikal dan RTL). Jika kotak alat 'end' berada di sisi berlawanan. Default-nya adalah 'start'. |
trashcan
|
boolean | Menampilkan atau menyembunyikan tempat sampah. Nilai defaultnya adalah true jika
toolbox memiliki kategori, false jika tidak. |
zoom |
objek | Mengonfigurasi perilaku zoom. Lihat Zoom. |