Jenis pertanyaan - Input numerik

Deskripsi singkat

Jenis pertanyaan ini meminta peserta survei untuk memasukkan satu angka.

Contoh: Question_example_numerical_input.zip.

Opsi umum

Wajib diisi

Deskripsi

Opsi ini memungkinkan administrator survei meminta responden untuk menjawab pertanyaan survei tertentu. Jika pertanyaan wajib tidak dijawab, responden tidak dapat melanjutkan ke halaman berikutnya. Jika Anda memiliki pertanyaan dengan beberapa subpertanyaan dan hanya subpertanyaan tertentu yang harus dijawab, gunakan atribut jawaban minimum yang terdapat di tab Logika.

Jika Anda menggunakan salah satu tema bawaan dan atribut pertanyaan wajib diaktifkan, tanda bintang merah akan ditampilkan di samping pertanyaan. Jika Anda ingin menyembunyikannya, silakan lihat petunjuk ini.

Opsi yang tersedia

• On - Pertanyaan harus dijawab sebelum peserta dapat melanjutkan ke halaman berikutnya - opsi jawaban 'Tidak dijawab' tidak pernah ditampilkan.
• Soft - Jika pertanyaan tidak dijawab, peringatan akan ditampilkan saat mencoba melanjutkan ke halaman berikutnya - namun, peserta dapat memilih untuk mengabaikan peringatan tersebut dan melanjutkan. Perlu diperhatikan bahwa opsi 'Tidak dijawab' tetap ditampilkan (jika diaktifkan di pengaturan presentasi survei)
• Off (default) - Pertanyaan boleh dibiarkan tidak dijawab

Validasi (menggunakan persamaan reguler) (preg_validation)

Deskripsi

Opsi ini memungkinkan Anda menentukan persamaan reguler yang dapat digunakan untuk memvalidasi semua bagian dari sebuah pertanyaan.

Jika ada nilai pertanyaan atau subpertanyaan yang tidak memenuhi persyaratan validasi, warna latar belakang kolom isian teks akan berubah menjadi merah sehingga pengguna dapat dengan mudah melihat bagian pertanyaan mana yang perlu diperbaiki. Dengan demikian, Anda dapat melakukan validasi langsung di halaman. Dengan cara ini, Anda tidak perlu menunggu pengguna mengklik tombol kirim untuk memvalidasi pertanyaan yang bersangkutan.

Nilai yang valid

• Persamaan reguler apa pun yang valid

Contoh

• Klik di sini untuk melihat berbagai contoh.

Kondisi

Deskripsi

Jika nilai hasil kondisi adalah "1" atau "true", pertanyaan tersebut "relevan" dalam konteks survei, yaitu ditampilkan kepada peserta survei. Jika tidak, pertanyaan akan disembunyikan. Setiap pertanyaan survei memungkinkan Anda menentukan persamaan yang berhubungan. Fungsi ini merupakan pengganti kondisi dan mendukung logika kondisional yang jauh lebih kompleks.

Penyorotan Sintaks

Setiap kali Anda menyimpan kondisi, kondisi tersebut akan dievaluasi dan sintaksnya disorot. Setiap kesalahan akan diberi kode warna sehingga Anda dapat dengan cepat menemukan dan memperbaikinya.

 Hint: Untuk memeriksa apakah semua kondisi digunakan dengan benar dalam survei Anda, baca tentang fitur tampilkan file logika kami.

Nilai yang valid

• Kondisi apa pun yang menggunakan sintaks ExpressionScript, tanpa tanda kurung kurawal di sekelilingnya.

Contoh

Berikut adalah contoh-contoh yang baik dari penyorotan sintaks.

Tampilan

Prefiks (prefix)

Deskripsi

Nilai teks yang ditampilkan sebagai prefiks sebelum kotak input teks. Prefiks ditampilkan tepat di sebelah kiri input.

Jika layar kecil, prefiks akan ditampilkan di atas input. Jika Anda ingin tetap menampilkannya di sebelah kiri ^{(New in 3.0.0 )}: tambahkan kelas suffix-prefix-force ke pertanyaan.

Nilai yang valid

• Karakter atau kumpulan karakter apa pun yang ingin Anda tampilkan sebelum input

Contoh

Memasukkan nilai "$" pada atribut ini akan menampilkan tanda dolar tepat sebelum kotak input teks.

Sufiks (suffix)

Deskripsi

Nilai teks yang ditambahkan sebagai sufiks pada kotak isian teks. Sufiks ditampilkan tepat di sebelah kanan kolom isian.

Pada layar kecil: sufiks ditampilkan di bawah kolom isian. Jika Anda ingin tetap menampilkannya di sebelah kanan ^{(New in 3.0.0 )}: tambahkan kelas suffix-prefix-force ke pertanyaan.

Nilai yang valid

• Karakter apa pun atau kumpulan karakter yang ingin Anda tampilkan setelah kolom isian

Contoh

Memasukkan nilai "%" pada atribut ini akan menampilkan tanda persen tepat setelah kotak isian teks.

Tema pertanyaan (question_theme)

Deskripsi

Fitur ini memungkinkan Anda menggunakan tema khusus untuk pertanyaan yang bersangkutan.

Opsi yang tersedia

• Tema pertanyaan yang Anda buat, yang terdapat di bawah Tema pertanyaan pada panel Tema.

Lihat: Tema pertanyaan

Catatan: Fitur ini sedang dalam pengembangan saat ini.

Lebar kotak input (text_input_width)

Deskripsi

Atribut ini mengatur lebar kotak input teks (dari "wrapper" kotak input teks). Kotak input digunakan untuk memasukkan jawaban atas (sub)pertanyaan. Jika nilai lebarnya cukup besar, kotak input teks akan ditampilkan pada baris berikutnya. Perlu diperhatikan bahwa opsi ini tidak mengatur ukuran input atau lebar seluruh kolom!

Opsi yang tersedia

• Default: Jika dipilih, sebuah nilai default akan diberikan pada atribut ini sehingga label dan kotak input teksnya berada pada baris yang sama. Misalnya, jika lebar kotak input teks adalah 41%, nilai lebar kotak input teks akan berupa nilai yang memungkinkan label dan kotak input berada pada baris yang sama (dalam hal ini 58%). Jika lebar kotak input teks lebih dari 58%, kotak input teks akan ditampilkan pada baris berikutnya.
• 8%; 17%...92%, 100%: semakin besar nilai yang dipilih, semakin lebar kotak input teks.

Contoh

• Jika Anda ingin bagian input ditampilkan di bawah subpertanyaan/label, pilih opsi 100% dari daftar tarik-turun.

Sembunyikan keterangan (hide_tip)

Deskripsi

Sebagian besar pertanyaan biasanya menyertakan keterangan seperti "Harap pilih salah satu opsi berikut" atau teks petunjuk tentang cara mengisi pertanyaan. Atribut ini memungkinkan Anda untuk menonaktifkan atau mengaktifkan keterangan/petunjuk tersebut.

Keterangan/petunjuk ini mencakup pesan kriteria validasi (seperti jumlah jawaban min/maks, Nilai total setara/min/maks). Jika hide_tip diaktifkan, pesan-pesan ini akan disembunyikan. Namun, jika pengguna memasukkan data yang tidak valid, keterangan akan muncul. Keterangan akan berwarna merah, lalu berubah menjadi hijau setelah kriteria validasi terpenuhi.

Opsi yang tersedia

• Aktif - keterangan/petunjuk disembunyikan;
• Nonaktif (default).

Ukuran kotak input teks (input_box_size)

 Hint: This feature is available starting in version 3.0.0

Deskripsi

Fungsi ini memungkinkan Anda mengatur ukuran area teks (kotak input teks). Secara default, LimeSurvey menampilkan kotak input dengan ukuran bawaan. Hal ini dapat diubah dengan menggunakan fungsi ini.

Untuk memindahkan kotak ke baris berikutnya, Anda perlu memperbesar ukuran pembungkus (wrapper). Caranya, tingkatkan nilai atribut lebar input teks.

Nilai yang valid

• Nilai numerik apa pun

Selalu sembunyikan pertanyaan ini (hidden)

Deskripsi

Jika diaktifkan, pertanyaan akan selalu disembunyikan - tidak akan ditampilkan kepada partisipan survei. Fungsi ini dapat digunakan dalam skenario berikut:

• Jika Anda ingin mengisi pertanyaan terlebih dahulu melalui URL dan tidak ingin pertanyaan tersebut ditampilkan di layar. Hal ini menggantikan semua kondisi yang digunakan dalam survei karena pertanyaan yang bersangkutan bahkan tidak disertakan di halaman.
• Jika Anda ingin menyimpan atau menghitung nilai secara langsung melalui ExpressionScript - Presentasi.

Catatan: Jenis pertanyaan umum yang digunakan dengan fungsi ini adalah jenis Persamaan.

Opsi yang tersedia

• Aktif
• Nonaktif (default)

Kelas CSS (css_class)

Deskripsi

Jika Anda ingin menambahkan kelas CSS khusus pada pertanyaan tertentu, Anda dapat memasukkan nama kelas CSS di kotak ini. Pastikan Anda memberi spasi kosong di antara nama-nama kelas yang berbeda.

Nilai yang valid

• Teks apa pun dengan spasi di antara nama-nama kelas CSS yang berbeda.

 Hint: Anda juga dapat menyisipkan ekspresi di kotak ini ^{(New in 3.0.0 )}. Perlu diingat bahwa hasil ekspresi tidak akan diperbarui secara dinamis.

  Menurut W3C, nama kelas CSS hanya boleh berisi karakter [a-zA-Z, dan 0-9] serta karakter ISO 10646 U+00A1 ke atas, ditambah tanda hubung (-) dan garis bawah (_). Nama tersebut tidak boleh diawali dengan angka, atau tanda hubung yang diikuti angka. LimeSurvey melakukan encoding pada kelas CSS, tetapi tidak memperbaikinya sepenuhnya.

Bantuan relevansi untuk survei dapat dicetak (printable_survey_relevance_help)

Deskripsi

Jika Anda ingin mencetak survei, Anda juga dapat mencetak persamaan yang berhubungan untuk setiap pertanyaan. Namun, jika Anda ingin menampilkan penjelasan, bukan ekspresi, pada formulir cetak, isi kotak ini dengan teks penjelasan untuk persamaan yang berhubungan tersebut.

Nilai yang valid

• Teks dan/atau angka apa pun yang ingin Anda tampilkan pada formulir cetak.

Input

Karakter maksimum (maximum_chars)

Deskripsi

Pengaturan ini memungkinkan Anda menetapkan jumlah karakter maksimum yang dapat dimasukkan pada pertanyaan berbasis teks. Misalnya, jika Anda memasukkan nilai 20, peserta tidak dapat memasukkan lebih dari 20 karakter.

Nilai yang valid

• Bilangan bulat apa pun di atas 0

Nilai minimum masukan angka (min_num_value_n)

Deskripsi

Nilai minimum masukan angka yang dapat dimasukkan oleh responden ke dalam kotak isian.

Nilai yang valid

• Bilangan bulat apa pun di atas 0
• Angka apa pun
• Kode SGQA apa pun
• Kode pertanyaan apa pun (nama variabel)
• Persamaan apa pun, menggunakan sintaks ExpressionScript, tanpa kurung kurawal di sekelilingnya.

Bilangan bulat saja (num_value_int_only)

Deskripsi

Jika diaktifkan, responden hanya dapat memasukkan nilai bilangan bulat pada kotak isian.

Opsi yang tersedia

• Ya
• Tidak (default)

Nilai maksimum masukan angka (max_num_value_n)

Deskripsi

Nilai maksimum masukan angka yang dapat dimasukkan responden ke dalam kotak input.

Nilai yang valid

• Nilai bilangan bulat apa pun di atas 0
• Angka apa pun
• Kode SGQA apa pun
• Kode pertanyaan apa pun (nama variabel)
• Persamaan apa pun, menggunakan sintaks ExpressionScript, tanpa tanda kurung kurawal di sekelilingnya.

Logika

Nama grup pengacakan (random_group)

Deskripsi

Pengaturan ini menempatkan pertanyaan ke dalam grup pengacakan tertentu. Semua pertanyaan dalam grup tersebut akan ditampilkan dalam urutan acak kepada responden survei.

Anda dapat menemukan contoh survei yang menggunakan nama grup pengacakan di contoh survei ExpressionScript.

Nilai yang valid

Cukup masukkan string apa pun yang Anda inginkan (misalnya: 'group1'). Semua pertanyaan yang memiliki string yang sama pada kolom nama grup pengacakan akan diacak posisinya dalam survei (=saling bertukar tempat secara acak).

Pratinjau Untuk melihat pratinjau pertanyaan, gunakan fungsi pratinjau survei alih-alih fungsi pratinjau grup pertanyaan, karena fungsi yang kedua dilaporkan tidak menampilkan pertanyaan dalam urutan acak.

Persamaan validasi pertanyaan (em_validation_q)

Deskripsi

Ini adalah persamaan yang digunakan untuk memvalidasi seluruh pertanyaan (misalnya, semua bagiannya secara kolektif untuk pertanyaan dengan banyak jawaban). Jika pertanyaan gagal memenuhi kriteria validasi, pesan em_validation_q_tip akan ditampilkan (menggunakan gaya CSS .error). Tip ini menggunakan gaya CSS .em_q_fn_validation, yang disembunyikan secara default di dalam template.css.

Perbedaan utama antara fitur ini dan persamaan validasi subpertanyaan (opsi em_validation_sq) adalah bahwa pada fitur ini, jika pertanyaan (atau bagian pertanyaan) gagal validasi, pesan kesalahan dapat ditampilkan. Pada validasi subpertanyaan, setiap sel isian teks (misalnya, pada jenis pertanyaan larik, tetapi juga dapat diterapkan pada jenis pertanyaan dengan isian tunggal) akan diberi gaya sehingga warna latar belakangnya menjadi merah (muda).

Nilai yang valid

• Persamaan apa pun yang menggunakan sintaks ExpressionScript, tanpa tanda kurung kurawal di sekelilingnya.

Contoh

• Anda ingin mengumpulkan informasi demografis dari pengguna melalui pertanyaan Beberapa teks pendek, dan Anda ingin memvalidasi bahwa pengguna telah memasukkan alamat surel dan nomor telepon yang valid.

Contoh ini menunjukkan tampilan pertanyaan dengan jawaban yang tidak valid:

Dan inilah tampilannya dengan satu jawaban yang tidak valid:

Berikut cara mengedit pertanyaan untuk memasukkan informasi tersebut:

Dan berikut sebagian keluaran Show Logic File yang memungkinkan Anda memeriksa keakuratan ekspresi Anda dan memastikan tidak ada kesalahan sintaks:

Seperti yang Anda lihat, persamaan validasi menguji bahwa surel dan nomor telepon keduanya kosong atau cocok dengan filter persamaan reguler.

Tip validasi hanya menampilkan pesan peringatan jika telepon atau surel tampak tidak valid.

 Hint: Untuk membuat pesan validasi yang kompleks, baca tentang penggunaan ExpressionScript.

Jika Anda ingin mengimpor contoh di atas ke instalasi LimeSurvey Anda, unduh berkas .lsq berikut: Em_validation_q_example.zip.

 Hint: Ingat, LimeSuvey menggunakan sintaks Perl untuk persamaan reguler, jadi persamaan tersebut harus diawali dan diakhiri dengan / (karakter garis miring)!

Tips untuk persamaan validasi seluruh pertanyaan (em_validation_q_tip)

Deskripsi

Jika Anda menggunakan persamaan validasi pertanyaan, Anda dapat menggunakan kotak ini untuk menampilkan pesan opsional sebagai tips pertanyaan tentang cara pertanyaan tersebut harus diisi.

Nilai yang valid

• String atau persamaan apa pun yang menggunakan sintaks ExpressionScript.

Contoh

Lihat contoh pada bagian wiki persamaan validasi pertanyaan - contoh tersebut menunjukkan cara menyesuaikan tips untuk menampilkan bagian mana dari pertanyaan Beberapa teks pendek yang tidak memenuhi kriteria validasi.

Persamaan validasi subpertanyaan (em_validation_sq)

Deskripsi

Ini adalah persamaan yang digunakan untuk memvalidasi setiap subpertanyaan (kolom teks) secara individual. Kolom teks yang tidak memenuhi kondisi validasi ini akan memiliki warna latar belakang merah muda (menggunakan gaya CSS .em_sq_fn_validation) untuk menyoroti kesalahan. Perlu diketahui bahwa opsi ini tersedia selain opsi validasi berbasis persamaan reguler.

Nilai yang valid

Persamaan apa pun yang menggunakan sintaks ExpressionScript, tanpa tanda kurung kurawal di sekelilingnya.

Contoh

Misalnya, jika Anda hanya ingin mengizinkan angka kelipatan 3 sebagai jawaban, persamaannya adalah:

(this / 3) == floor(this/3)

Variabel khusus this secara otomatis diganti dengan referensi ke sel isian teks yang aktif.

Tips untuk persamaan validasi subpertanyaan (em_validation_sq_tip)

Deskripsi

Jika Anda menggunakan em_validation_sq, ini adalah pesan/tips opsional yang akan ditampilkan jika jawaban yang dimasukkan tidak benar.

Nilai yang valid

• String apa pun

Contoh

• Melanjutkan contoh validasi surel, tips tersebut dapat berupa "Harap masukkan alamat surel yang valid."

Lainnya

Sisipkan pemisah halaman pada versi cetak (page_break)

Deskripsi

Atribut ini hanya aktif saat Anda benar-benar mencetak survei dari Tampilan Cetak. Atribut ini memaksa pemisah halaman sebelum pertanyaan.

Opsi yang tersedia

• Aktif
• Nonaktif (default)

Statistik

Tampilkan dalam statistik publik (public_statistics)

Deskripsi

Atribut ini memungkinkan administrator survei untuk memilih apakah hasil pertanyaan tertentu ditampilkan kepada partisipan survei setelah mereka mengirimkan survei.

Catatan: Agar statistik ditampilkan di halaman terakhir, jangan lupa mengaktifkan fungsi ini dari Pengaturan presentasi & navigasi. Jika tidak, tautan statistik tidak akan ditampilkan di akhir survei Anda.

Pengaturan default untuk setiap pertanyaan adalah 'Off' (=tidak menampilkan statistik pertanyaan kepada responden). Anda harus mengaktifkannya untuk setiap pertanyaan jika ingin menampilkan statistik survei dari pertanyaan tertentu tersebut kepada partisipan survei setelah survei dikirim.

Opsi yang tersedia

• On
• Off (default)

Tampilkan grafik (display_chart)

Deskripsi

Atribut ini memungkinkan administrator survei memilih apakah grafik yang berisi hasil pertanyaan akan ditampilkan kepada partisipan survei setelah mereka selesai mengisi survei.

Catatan: Agar grafik ditampilkan di halaman terakhir, Anda harus mengaktifkan opsi berikut:

• Pengaturan survei Statistik publik dari Pengaturan presentasi & navigasi
• Pengaturan survei Tampilkan grafik dari Pengaturan presentasi & navigasi
• Atribut pertanyaan Statistik publik, dan
• atribut pertanyaan Tampilkan grafik.

Opsi yang tersedia

• On
• Off (default)

Jenis grafik (chart_type)

Deskripsi

Atribut ini memungkinkan administrator survei memilih jenis grafik yang akan ditampilkan kepada responden setelah ia selesai mengisi survei.

Catatan: Jangan lupa mengubah pengaturan pertanyaan dan pengaturan survei agar grafik ditampilkan di akhir survei. Untuk detail lebih lanjut, lihat bagian wiki tentang atribut pertanyaan Tampilkan grafik.

Opsi yang tersedia

• Grafik batang
• Grafik Lingkaran
• Radar
• Garis
• PolarArea
• Doughnut