Phone

Phone digunakan untuk menginputkan nomor telepon, misalnya nomor ponsel PIC atau kontak vendor. Nomor ditampilkan berkelompok saat diketik (812-3456-7890). Nilai yang tersimpan selalu berformat internasional E.164, misalnya +6281234567890.

Mapping ke Engine

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.
• Placeholder: Teks petunjuk di dalam field selama masih kosong. Mendukung dua bahasa (EN & ID). Bila kosong, dipakai contoh nomor sesuai negara.
• Default country: Negara awal beserta kodenya: Indonesia (+62), Malaysia (+60), atau Singapore (+65).
• Let users change the country: Bila aktif, pengguna dapat memilih kode negara ID +62, MY +60, atau SG +65 di depan field. Bila mati, kode negara tetap.
• Accept: Jenis nomor yang diterima.
  • Mobile numbers only: hanya nomor ponsel.
  • Mobile or landline: nomor ponsel atau nomor telepon rumah/kantor.
• 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: Bila properti berikut diisi, form hanya dapat disubmit ketika kondisinya terpenuhi; jika tidak, muncul pesan validasi. Format nomor selalu dicek, juga saat field tidak wajib.
  • Required: Komponen wajib diisi sebelum form disubmit.
  • Required If: Komponen wajib diisi hanya bila ekspresi FEEL terpenuhi (validasi bersyarat).

Perilaku saat diisi

• Pengguna boleh mengetik 0812-3456-7890, 812 3456 7890, atau +62 812-3456-7890. Ketiganya tersimpan sama: +6281234567890.
• Karakter selain angka dibuang. Angka 0 di depan dibuang.
• Selama nomor belum valid, di bawah field tampil "Example: 0812-3456-7890". Setelah valid, tampil "Saved as +6281234567890".
• Nomor yang tidak sesuai aturan negara ditolak dengan pesan "Enter a valid mobile number for Indonesia, e.g. 0812-3456-7890". Untuk Mobile or landline, pesannya "Enter a valid phone number for Indonesia".
• Bila Required aktif dan field kosong, muncul "PIC mobile number is required".
• Saat pengaturan disimpan, aturan nomor ikut tersimpan sebagai pola di spec. Server juga menolak nomor yang tidak sesuai pola.
• Bila pengguna mengganti negara, nomor yang sudah diketik dipakai ulang dengan kode negara baru.