Anatomi kolom

Nilai

Semua kolom harus memiliki nilai, yang merupakan sumber tepercaya untuk data kolom. Nilai 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 mudah dibaca dan merepresentasikan nilai kolom. Hal ini tidak berarti keduanya sama. Misalnya, teks pada kolom boolean dapat berupa 'Aktif' atau 'Nonaktif', sedangkan nilainya adalah true atau false.

Teks ini ditampilkan saat blok diciutkan, untuk aksesibilitas, dan secara opsional dapat menjadi bagian dari tampilan saat diblokir.

Kolom yang dapat diedit vs. yang tidak dapat diedit

Secara umum, kolom yang dapat diedit memungkinkan pengguna melakukan perubahan pada kode, sedangkan kolom yang tidak dapat diedit menampilkan informasi kepada pengguna tentang blok. Kolom yang dapat diedit dapat menampilkan editor lengkap saat diklik.

Kolom yang dapat diedit meliputi:

• Kotak centang
• Warna
• Drop-down
• Number
• Input Teks

Kolom yang tidak dapat diedit mencakup:

• Label
• Label yang Dapat Diserialisasi
• Gambar

Serialisasi

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

Kolom berseri mencakup:

• Kotak centang
• Warna
• Drop-down
• Number
• Input Teks
• Label yang Dapat Diserialisasi

Kolom yang tidak diserialisasi mencakup:

• Label
• Gambar

Perhatikan bagaimana kolom Label yang Dapat Diserialisasi tidak dapat diedit, tetapi dapat diserialisasi. Artinya, hanya dapat diedit secara terprogram, bukan melalui UI yang terlihat oleh pengguna. Setelah diedit, nilainya akan dienkode dalam JSON/XML yang dihasilkan.

Pembuatan kode

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

Untuk mengetahui informasi selengkapnya tentang cara menggunakan nilai kolom dalam generator, lihat pembuatan kode kolom.

Tampilan di blok

Tampilan dalam blok kolom adalah kumpulan elemen SVG yang merepresentasikan nilai kolom. Mereka menempati ruang di blok, dan saat ukurannya berubah, mereka akan memaksa ukuran blok berubah. Tampilan dalam blok kolom dapat sederhana atau kompleks, bergantung pada kebutuhannya.

Berikut beberapa contoh tampilan dalam blok yang berbeda, dalam urutan peningkatan kompleksitas.

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

Tampilan editor

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

Berikut beberapa contoh editor yang berbeda, dalam urutan peningkatan kompleksitas.

Jenis kolom	Deskripsi
Kotak centang	Tidak ada editor saat diklik. Tampilan di blok diperbarui.
Input angka	Editor teks yang di-overlay di atas tampilan dalam blok. Pengguna dapat mengetik; editor dapat berubah warna untuk menunjukkan nilai yang 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.

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