Color picker

Color picker digunakan untuk memilih satu warna, misalnya warna label atau penanda kategori. Pengguna mengklik bulatan warna dari daftar yang disiapkan. Bila diizinkan, pengguna juga bisa memasukkan warna lain lewat Custom…. Yang disimpan hanya kode hex, bukan nama warnanya. Komponen ini ada di grup Select pada palette.

Mapping ke Engine

Bila belum memilih warna, nilai yang dikirim adalah "".

Properties

• Name: Label komponen yang ditampilkan ke pengguna. Mendukung dua bahasa (EN & ID).
• Key: Mengikat komponen ke process variable yang menyimpan nilainya saat form disubmit. Default label_color. Key yang berisi spasi atau sudah dipakai field lain membuat Save Changes nonaktif.
• Colours allowed:
  • Listed colours only: pengguna hanya bisa memilih warna dari daftar.
  • Listed + any colour: ditambah bulatan "Custom…" berisi pemilih warna dan isian hex.
• Colours: Daftar warna, maksimal 16, ditambah lewat Add colour. Tiap warna punya bulatan (klik untuk membuka pemilih warna), kode hex, serta nama EN dan ID. Urutan bisa dipindah naik atau turun. Kode hex disimpan huruf besar; singkatan seperti #1e6 menjadi #11EE66. Galat yang membuat Save Changes nonaktif:
  • "Keep at least 2 colours": mode Listed colours only dengan kurang dari 2 warna. Mode Listed + any colour cukup 1 warna.
  • "Colour N: use a hex colour like #1E66F5": kode hex tidak valid.
  • "Every colour needs an English name": nama EN kosong.
  • "Two colours share #1E66F5": dua warna memakai kode hex yang sama.
• Show colour names under the swatches: Menampilkan nama warna di bawah tiap bulatan. Bila mati, hanya bulatan yang tampil.
• Tooltip: Teks bantuan singkat (maks. 255 karakter) yang muncul saat kursor diarahkan ke ikon informasi; diaktifkan lewat toggle.
• Disabled: Menonaktifkan komponen sehingga nilainya hanya bisa dibaca dan tidak dapat diisi.
• Hide If: Ekspresi FEEL untuk menyembunyikan komponen. Komponen disembunyikan ketika ekspresi bernilai true, dievaluasi ulang saat nilai field lain berubah.
• Validation:
  • Required: Komponen wajib diisi sebelum form disubmit. Komponen ini tidak memiliki Required If.

Perilaku saat diisi

• Selama belum memilih, di bawah bulatan tampil "No colour picked yet".
• Klik bulatan untuk memilih. Di bawahnya tampil nama dan kode hex warna terpilih, misalnya "Blue #1E66F5". Panah kiri/kanan memindah pilihan.
• Custom… membuka isian "Hex code" dan pemilih warna. Klik "Use colour" untuk memakai warna tersebut. Kode yang tidak valid ditolak dengan "Use a hex colour like #1E66F5".
• Pesan validasi:
  • "<Name> is required": Required aktif dan belum memilih warna, misalnya "Label colour is required".
  • "Pick one of the listed colours": mode Listed colours only tetapi nilai tidak ada di daftar, misalnya dari draft lama.
• Bila Disabled aktif, warna terpilih tetap terlihat dan tidak bisa diubah. Nilainya tidak ikut dikirim saat form disubmit.
• Nilai ikut tersimpan di draft dan tampil lagi saat task dibuka ulang.