Anatomi kolom

Nilai

Semua kolom harus memiliki nilai, yang merupakan sumber kebenaran untuk data kolom. Ini dapat berupa jenis apa pun (string, angka, array, tanggal, dll). Kolom dapat menggunakan validator untuk membatasi nilai atau menerjemahkan ke format yang dapat dibaca mesin (misalnya, menormalisasi format tanggal).

Teks

Semua kolom berisi teks, yang merupakan string sederhana yang dapat dibaca manusia yang mewakili nilai kolom. Ini tidak berarti bahwa keduanya sama. Misalnya, teks pada kolom boolean mungkin 'Aktif' atau 'Nonaktif', sedangkan nilainya adalah 'true' atau 'false'.

Teks inilah yang ditampilkan saat blok diciutkan, untuk aksesibilitas, dan dapat secara opsional menjadi bagian dari tampilan on-block.

Kolom yang dapat diedit vs tidak dapat diedit

Secara umum, kolom yang dapat diedit memungkinkan pengguna membuat perubahan pada kode, sementara kolom yang tidak dapat diedit menampilkan informasi tentang pemblokiran kepada pengguna. Kolom yang dapat diedit dapat menampilkan editor kaya saat diklik.

Kolom yang dapat diedit meliputi:

Kolom yang tidak dapat diedit meliputi:

Serialisasi

Nilai kolom yang dapat diserialisasi dienkode dalam format simpan (JSON atau XML). Semua kolom yang dapat diedit dapat diserialisasi karena nilainya dinamis. Nilai kolom yang tidak dapat diedit biasanya tidak dinamis, sehingga biasanya tidak diserialisasi.

Kolom berseri meliputi:

Kolom yang tidak diserialisasi meliputi:

Perhatikan bahwa kolom Label Serializable tidak dapat diedit, tetapi dapat diserialisasi. Artinya, API tersebut hanya dapat diedit secara terprogram, bukan melalui UI yang terlihat oleh pengguna. Setelah diedit, nilainya dienkode ke JSON/XML yang dihasilkan.

Pembuatan kode

Selain menghubungkan dan memutuskan sambungan blok, kolom adalah satu-satunya cara bagi pengguna untuk mengontrol kode yang dihasilkan oleh Blockly. Editor yang disediakan oleh kolom memungkinkan pengguna mengubah nilai yang disimpan oleh kolom tersebut. Generator blok kemudian dapat mengakses nilai kolom untuk digunakan dalam kode yang dihasilkan.

Untuk mengetahui informasi lebih lanjut tentang cara menggunakan nilai kolom di generator, lihat pembuatan kode kolom.

Layar on-block

Tampilan on-block kolom adalah kumpulan elemen SVG yang mewakili nilai kolom. Bentuk ini mengambil ruang pada blok, dan saat berubah ukurannya, model ini memaksa blok untuk berubah ukurannya. Tampilan on-block kolom bisa sederhana atau kompleks, bergantung pada kebutuhannya.

Ini adalah beberapa contoh tampilan on-block yang berbeda, untuk meningkatkan kompleksitas.

Jenis kolom Deskripsi
Label Hanya berisi elemen teks.
Sudut Berisi persegi panjang latar belakang, elemen teks, dan simbol derajat.
Kura-kura Berisi rect latar belakang, elemen teks, dan banyak elemen SVG yang digunakan untuk membangun grafis turtle.

Tampilan editor

Jika pengguna mengklik kolom yang dapat diedit, kolom tersebut mungkin menampilkan editor yang kompleks secara arbitrer.

Ini adalah beberapa contoh editor yang berbeda, untuk meningkatkan kompleksitasnya.

Jenis kolom Deskripsi
Kotak centang Tidak ada editor saat diklik. Pembaruan tampilan blok.
Input angka Editor teks yang ditempatkan di atas tampilan yang diblokir. Pengguna dapat mengetik; editor dapat berubah warna untuk menunjukkan nilai buruk.
Pemilih sudut Pemilih sudut memiliki editor teks untuk mengetik angka dan editor yang dapat ditarik untuk memilih sudut secara visual.

Mode tampilan lainnya

Mode diciutkan: pengguna menciutkan blok.Blok menampilkan representasi teks dari nilainya, menggunakan teks yang ditampilkan oleh masing-masing kolom.

Blok kebun kura-kura runtuh

Mode aksesibilitas: pengguna mungkin menggunakan pembaca layar atau teknologi serupa untuk berinteraksi dengan Blockly. Teks kolom dapat dibacakan kepada pengguna.