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 kotak alat memiliki kategori, false jika tidak. |
comments |
boolean | Apakah menu konteks blok menyertakan item untuk menambahkan atau menghapus komentar. Nilai defaultnya adalah true jika kotak alat memiliki kategori,false jika tidak. |
css |
boolean | Jika salah (false), jangan menyuntikkan CSS (penyediaan 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 kotak alat memiliki kategori, false jika tidak. |
grid |
objek | Mengonfigurasi petak yang dapat digunakan untuk menyelaraskan blok. Lihat Petak. |
horizontalLayout |
boolean | Jika toolbox true horizontal, jika toolbox 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 flyout tempat sampah. '0' menonaktifkan fitur tersebut. Nilai defaultnya adalah '32'. |
media |
string | Jalur dari halaman (atau frame) ke direktori media Blockly. Default-nya 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 daftar dan string true harus diindeks dari 1, jika false diindeks dari 0. Setelan defaultnya adalah true. |
plugins |
objek | Objek yang memetakan nama jenis ke class pengganti atau nama terdaftar class pengganti. Lihat Menyisipkan kelas 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 dikemas 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 kotak alat 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 kiri (jika vertikal dan LTR) atau 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 kotak alat memiliki kategori, false jika tidak. |
zoom |
objek | Mengonfigurasi perilaku zoom. Lihat Zoom. |