Image

Image digunakan untuk menampilkan gambar di antara field form, misalnya denah ruangan, contoh pengisian, atau foto dari langkah sebelumnya. Gambar bisa berasal dari berkas yang diunggah di builder, URL https, atau process variable berisi berkas.

Mapping ke Engine

Komponen ini tidak menyimpan process variable. Saat form disubmit, payload tidak berisi key gambar. Spec form hanya menyimpan data berkas (id, nama, tipe, ukuran px), bukan isi gambarnya.

Properties

• Name: Judul kecil di atas gambar, dalam dua bahasa (EN dan ID). Juga dipakai sebagai judul dialog saat gambar diperbesar.
• Key: Identitas komponen di dalam form. Terisi otomatis saat komponen diletakkan di kanvas. Key ini bukan process variable.
• Image source: Asal gambar, pilih salah satu.
  • Upload: Unggah berkas PNG, JPG, WebP, atau SVG lewat seret-lepas atau "Browse file". Setelah terunggah tampil nama berkas, tipe, dan ukurannya, misalnya "PNG · 720 × 450 px". Ikon hapus membuang berkas. Berkas disimpan sebagai aset form: tidak ikut terhapus saat lampiran draft dibersihkan (default 24 jam), dan bisa dilihat semua user di workspace.
  • URL: Alamat gambar yang diawali https:// dengan nama host lengkap. Alamat lain ditolak dengan pesan "Use an https:// address".
  • Process variable: Variabel berkas dari langkah lain di proses yang sama. Pilihan diambil dari field File Upload, Signature, dan Template Upload.
• Decorative image: Aktifkan untuk gambar hiasan yang tidak membawa informasi. Alt text tidak lagi diperlukan dan pembaca layar melewati gambar.
• Alt text: Deskripsi gambar dalam dua bahasa untuk pengguna yang tidak bisa melihatnya. Isi teks EN bila gambar bukan Decorative; bila kosong editor menampilkan "Describe the image for people who can’t see it". Bila teks ID kosong, pengguna melihat teks EN.
• Caption: Keterangan opsional dalam dua bahasa, tampil di bawah gambar.
• Show the name: Menampilkan Name sebagai judul kecil di atas gambar.
• Size: Ukuran tampilan, pilih "Fit width", "Original size", atau "Fixed height". Gambar tidak pernah lebih lebar dari form.
• Height (120–600 px): Muncul bila Size bernilai Fixed height. Tinggi gambar antara 120 dan 600 px.
• Align: Posisi gambar, pilih "Left", "Center", atau "Right".
• Click to enlarge: Bila aktif, gambar bisa diklik untuk dibuka penuh di dialog. Tombol Esc menutup dialog.
• Hide If (tab Logic): Ekspresi FEEL untuk menyembunyikan gambar. Gambar disembunyikan ketika ekspresi bernilai true.
• Validation: Tidak ada aturan validasi. Tab Validation hanya berisi catatan "Display only — nothing to validate."

Perilaku saat diisi

• Selama gambar dimuat, tampil "Loading image…".
• Bila gambar gagal dimuat, tampil "Image couldn’t be loaded", alt text, dan tombol "Try again".
• Bila sumbernya Process variable dan variabel masih kosong, tampil "No image yet — it is set in an earlier step."
• Di kanvas builder, gambar tanpa sumber menampilkan "No image picked". Peringatan "URL needs https://" dan "Alt text missing" juga tampil di kanvas bila perlu.
• Di form start publik, gambar sumber Upload tampil tanpa login bila proses mengaktifkan Allow Public Start (lihat BPMN Settings). Jalur publik hanya memberikan gambar yang ada di form start proses itu.
• Gambar Upload yang dipilih sebelum aset form tersedia (rilis akhir Oktober 2026) masih berupa lampiran draft. Gambar itu tidak tampil di form publik. Unggah ulang gambarnya di Studio, simpan, lalu deploy ulang.
• Sumber Process variable tetap memerlukan login.