Kolom appearance di rtSurvey memungkinkan Anda menyesuaikan presentasi visual dan perilaku pertanyaan dalam survei Anda. Fitur ini meningkatkan pengalaman pengguna dan dapat secara signifikan meningkatkan efisiensi pengumpulan data. rtSurvey mendukung atribut appearance XLSForm standar dan memperluasnya dengan opsi tambahan.

Atribut Appearance XLSForm Standar

rtSurvey mendukung atribut appearance XLSForm standar berikut:

Atribut AppearanceJenis PertanyaanDeskripsi
multilinetextMembuat kotak teks multi-baris (terbaik untuk klien web)
minimalselect_one, select_multipleMenampilkan pilihan dalam menu dropdown
quickselect_oneMaju otomatis ke pertanyaan berikutnya setelah pemilihan (hanya mobile)
no-calendardateMenyembunyikan tampilan kalender (hanya mobile)
month-yeardateMemungkinkan pemilihan bulan dan tahun saja
yeardateMemungkinkan pemilihan tahun saja
horizontal-compactselect_one, select_multipleMenampilkan pilihan secara horizontal (hanya web)
horizontalselect_one, select_multipleMenampilkan pilihan secara horizontal dalam kolom (hanya web)
likertselect_oneMenyajikan pilihan sebagai skala Likert
compactselect_one, select_multipleMenampilkan pilihan berdampingan dengan padding minimal
quickcompactselect_oneMenggabungkan tampilan kompak dengan maju otomatis (hanya mobile)
field-listgroupsMenampilkan seluruh grup di satu layar (hanya mobile)
labelselect_one, select_multipleMenampilkan label pilihan tanpa masukan
list-nolabelselect_one, select_multipleMenampilkan masukan tanpa label (gunakan dengan label)
table-listgroupsMenampilkan pertanyaan dalam format tabel
signatureimageMengaktifkan penangkapan tanda tangan (hanya mobile)
drawimageMemungkinkan gambar tangan bebas (hanya mobile)
map, quick mapselect_one, select_one_from_fileMengaktifkan pemilihan dari fitur peta

Praktik Terbaik untuk Menggunakan Appearance

  1. Konsistensi: Gunakan atribut appearance secara konsisten di seluruh survei Anda untuk tampilan yang seragam.
  2. Mobile vs. Web: Pertimbangkan bagaimana appearance akan dirender di berbagai perangkat dan platform.
  3. Kinerja: Berhati-hatilah dengan atribut appearance yang mungkin memperlambat pemuatan formulir (misalnya, table-list untuk grup besar).
  4. Pengalaman Pengguna: Pilih appearance yang membuat entri data lebih mudah dan lebih intuitif bagi responden.
  5. Pengujian: Selalu uji formulir Anda di perangkat target untuk memastikan appearance berfungsi seperti yang diharapkan.

Teknik Lanjutan

Menggabungkan Appearance

Beberapa atribut appearance dapat digabungkan untuk tata letak yang lebih kompleks:

  | type | name | label | appearance |
|------|------|-------|------------|
| select_one options | choice | Pilih satu: | minimal compact |

Appearance Dinamis

rtSurvey memungkinkan perubahan appearance dinamis berdasarkan logika formulir:

  | type | name | label | appearance | relevant |
|------|------|-------|------------|----------|
| text | time | Masukkan waktu: | inline-[%H:%M] | ${show_time} = 'yes' |

Pertimbangan Aplikasi Mobile

  • Beberapa appearance (misalnya, quick, signature) khusus untuk perangkat mobile.
  • Uji secara menyeluruh di Android dan iOS untuk memastikan perilaku yang konsisten.

Atribut Appearance yang Diperluas rtSurvey

Selain appearance XLSForm standar, rtSurvey mendukung opsi khusus platform berikut:

Kontrol data dan tampilan

Atribut AppearanceJenis PertanyaanDeskripsi
invisibleapa sajaMenyembunyikan bidang dari tampilan sambil tetap mengumpulkan atau menghitung nilainya. Berbeda dari tipe hidden — bidang masih berpartisipasi dalam logika.
displaytitleapa sajaMemaksa tampilan label/judul bidang bahkan ketika seharusnya disembunyikan.
autopullselect_one, select_multipleSecara otomatis mengambil data eksternal untuk mengisi pilihan saat formulir dimuat atau bidang pemicu berubah.
floating_hinttext, integer, decimalMenampilkan teks petunjuk sebagai label mengambang di atas bidang masukan daripada di bawahnya.
calculate-buttoncalculateMenambahkan tombol yang terlihat yang memicu kalkulasi ulang bidang sesuai permintaan, daripada menghitung secara otomatis.

Tata letak

Atribut AppearanceJenis PertanyaanDeskripsi
1screengroupMemaksa seluruh grup untuk ditampilkan di satu layar terlepas dari ukuran grup.
columns(n)select_one, select_multipleMenampilkan pilihan dalam n kolom. Contoh: columns(3) menampilkan tiga kolom tombol radio.
gridformat<row=R col=C colspan=S align=center>apa sajaMemposisikan bidang dalam tata letak CSS-grid pada baris R, kolom C, merentangkan S kolom. Digunakan dengan advanced-extension/grid-layout.
ignore-simplifyapa sajaMenginstruksikan renderer formulir untuk melewati penyederhanaan atau pemadatan otomatis tata letak bidang ini.

Widget

Atribut AppearanceJenis PertanyaanDeskripsi
likertselect_oneMenyajikan pilihan sebagai baris skala Likert (sudah ada di tabel standar di atas; dikonfirmasi didukung).
distressselect_oneMerender pilihan sebagai widget visual Kessler Psychological Distress Scale (K10) dengan ikon emosional.

Integrasi API

Atribut AppearanceJenis PertanyaanDeskripsi
callapitext, integer, decimal, select_oneMengaktifkan integrasi panggilan API untuk bidang ini. Kolom kalkulasi harus berisi ekspresi callapi(). Lihat Call API.
callapi-verify(params)text, integer, decimalMemicu panggilan verifikasi API menggunakan parameter statis. Formulir memblokir kemajuan hingga API mengonfirmasi nilai.
callapi-verify(dynamicParams)text, integer, decimalSama seperti callapi-verify tetapi dengan parameter yang berasal dari nilai bidang lain saat runtime.

Format tanggal/waktu sebaris

Untuk bidang date, time, dan datetime, Anda dapat menentukan format tampilan kustom menggunakan string format yang ditambahkan ke appearance:

  inline-[%d/%m/%Y]
inline-1line-[%d/%m/%Y %H:%M]

Token format sama seperti format-date() dan format-date-time(). Lihat Fungsi — Fungsi tanggal dan waktu.

Contoh:

typenamelabelappearance
datetimeevent_timeTanggal dan waktu acarainline-[%d/%m/%Y %I:%M %p]
datebirth_dateTanggal lahirinline-[%d/%m/%Y]

Keterbatasan yang Diketahui

  • Appearance yang kompleks mungkin tidak dirender identik di semua platform.
  • Beberapa appearance rtSurvey lanjutan mungkin tidak didukung dalam mode offline.

Pemecahan Masalah Appearance

  1. Appearance Tidak Diterapkan: Periksa kesalahan ketik di kolom appearance.
  2. Rendering Tidak Konsisten: Verifikasi kompatibilitas dengan jenis pertanyaan dan platform.
  3. Masalah Kinerja: Pertimbangkan untuk menyederhanakan appearance yang kompleks, terutama untuk survei besar.
Apakah halaman ini membantu?