Week picker

Week picker digunakan untuk memilih satu minggu, misalnya untuk laporan mingguan. Minggu mengikuti ISO 8601: dimulai hari Senin, dan minggu ke-1 adalah minggu yang memuat Kamis pertama tahun itu.

Mapping ke Engine

Ketiga key selalu ada. Bila field kosong, nilainya {"week":null,"start":null,"end":null}.

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. Digenerate otomatis dan dapat disesuaikan.
• Show the dates: Bila aktif (default), field menampilkan "Week 46 · 9–15 Nov 2026". Bila mati, hanya "Week 46, 2026".
• Allow past weeks: Bila aktif (default), minggu sebelum minggu ini boleh dipilih. Bila mati, hanya minggu ini atau setelahnya.
• Weeks ahead: Berapa minggu ke depan yang boleh dipilih, 0-104. 0 berarti paling lambat minggu ini. Kosong berarti tanpa batas. Angka di luar rentang memunculkan "Use 0–104" dan Save Changes nonaktif.
• 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. Batas Allow past weeks dan Weeks ahead selalu diperiksa.

Perilaku saat diisi

• Field kosong menampilkan "Pick a week". Panah kiri dan kanan di samping field memindahkan pilihan satu minggu.
• Kalender menampilkan nomor minggu di kiri. Klik satu tanggal memilih seluruh minggu yang memuatnya, Senin sampai Minggu.
• Tombol This week memilih minggu ini. Tombol Clear mengosongkan pilihan.
• Minggu di luar batas tampil redup dan tidak bisa dipilih. Panah ikut mati bila minggu tujuannya di luar batas.
• Kalender bisa dipakai dengan keyboard: panah atas/bawah pindah satu minggu, PageUp/PageDown pindah satu bulan.
• "Minggu ini" dihitung dari tanggal hari ini di zona Asia/Jakarta, apa pun zona waktu browser.
• Minggu yang melewati pergantian tahun mengikuti tahun ISO. Contoh: 1 Jan 2027 tersimpan sebagai 2026-W53, 28 Des 2026 sampai 3 Jan 2027.
• Pesan validasi:
  • "<Name> is required": Required aktif dan field kosong, misalnya "Report week is required".
  • "Pick this week or a later one": minggu yang dipilih sebelum minggu ini, sementara Allow past weeks mati.
  • "Pick this week or an earlier one": minggu yang dipilih setelah minggu ini, sementara Weeks ahead 0.
  • "Pick a week up to <N> weeks ahead (week <nomor> at the latest)": minggu yang dipilih melewati batas Weeks ahead.
• Nilai ikut tersimpan di draft dan tampil lagi saat task dibuka ulang.
• Bila Disabled aktif, field tampil sebagai satu kotak berisi minggu terpilih, dan nilainya tidak ikut dikirim saat form disubmit.