Jenis soalan - Input berangka

Keterangan ringkas

Jenis soalan ini meminta peserta tinjauan memasukkan satu nombor.

Contoh: Question_example_numerical_input.zip.

Pilihan umum

Mandatori

Penerangan

Pilihan ini membolehkan pentadbir tinjauan meminta responden mereka menjawab soalan tinjauan tertentu. Jika soalan wajib tidak dijawab, responden tidak akan dapat meneruskan ke halaman seterusnya. Jika anda mempunyai soalan dengan beberapa sub-soalan dan anda hanya memerlukan sub-soalan tertentu dijawab, gunakan atribut jawapan minimum yang terletak di bawah tab Logik.

Jika anda menggunakan mana-mana tema pra-pasang dan atribut soalan mandatori diaktifkan, tanda asterisk merah akan dipaparkan di sebelah soalan. Jika anda ingin menyembunyikannya, sila semak arahan ini.

Pilihan yang tersedia

• On - Soalan mesti dijawab sebelum peserta boleh meneruskan ke halaman seterusnya - pilihan jawapan 'Tiada jawapan' tidak akan dipaparkan.
• Soft - Jika soalan tidak dijawab, amaran dipaparkan semasa cuba meneruskan ke halaman seterusnya - namun, peserta boleh memilih untuk mengabaikan amaran tersebut dan meneruskan. Perhatikan bahawa pilihan 'Tiada jawapan' masih dipaparkan (jika diaktifkan dalam tetapan penyampaian tinjauan)
• Off (lalai) - Soalan boleh dibiarkan tidak dijawab

Pengesahan (menggunakan ekspresi lazim) (preg_validation)

Penerangan

Pilihan ini membolehkan anda menentukan ekspresi lazim yang boleh digunakan untuk mengesahkan semua bahagian sesuatu soalan.

Jika mana-mana nilai soalan atau subsoalan tidak memenuhi syarat pengesahan, warna latar medan kemasukan teks akan bertukar menjadi merah supaya pengguna dapat melihat dengan mudah bahagian soalan yang perlu dibetulkan. Dengan itu, anda boleh melakukan pengesahan pada halaman. Dengan cara ini, anda tidak perlu menunggu pengguna mengklik butang hantar untuk mengesahkan soalan berkenaan.

Nilai yang sah

• Sebarang ekspresi lazim yang sah

Contoh

• Klik di sini untuk melihat pelbagai contoh.

Syarat

Penerangan

Jika nilai hasil syarat ialah "1" atau "true", soalan tersebut "berkaitan" dalam konteks tinjauan, iaitu ia dipaparkan kepada peserta tinjauan. Jika tidak, soalan tersebut disembunyikan. Mana-mana soalan tinjauan membolehkan anda menetapkan persamaan kaitan. Fungsi ini ialah pengganti kepada kondisi dan menyokong logik bersyarat yang jauh lebih kompleks.

Penyerlahan Sintaks

Setiap kali anda menyimpan syarat tersebut, ia akan dinilai dan sintaksnya diserlahkan. Sebarang ralat akan dikodkan warna supaya anda dapat mengesan dan membetulkannya dengan cepat.

 Hint: Untuk menyemak sama ada semua syarat digunakan dengan betul dalam tinjauan anda, baca tentang ciri fail logik paparan kami.

Nilai yang sah

• Mana-mana syarat yang menggunakan sintaks ExpressionScript, tanpa kurungan kurawan di sekelilingnya.

Contoh

Berikut ialah contoh-contoh yang baik bagi penyerlahan sintaks.

Paparan

Awalan (prefix)

Penerangan

Nilai teks yang dipaparkan sebagai awalan sebelum kotak input teks. Awalan dipaparkan di sebelah kiri input.

Jika skrin kecil, awalan akan dipaparkan di atas input. Jika anda mahu mengekalkannya di sebelah kiri ^{(New in 3.0.0 )} : tambah kelas suffix-prefix-force pada soalan.

Nilai yang sah

• Sebarang aksara atau set aksara yang ingin anda paparkan sebelum input

Contoh

Memasukkan nilai "$" untuk atribut ini akan menyebabkan tanda dolar dipaparkan tepat sebelum kotak input teks.

Akhiran (suffix)

Penerangan

Nilai teks yang ditambah sebagai akhiran pada kotak input teks. Akhiran dipaparkan tepat di sebelah kanan input.

Pada skrin kecil: akhiran dipaparkan di bawah input. Jika anda mahu mengekalkannya di sebelah kanan ^{(New in 3.0.0 )}: tambah kelas suffix-prefix-force pada soalan.

Nilai yang sah

• Mana-mana aksara atau set aksara yang ingin anda paparkan selepas input

Contoh

Memasukkan nilai "%" bagi atribut ini akan menyebabkan tanda peratus dipaparkan serta-merta selepas kotak input teks.

Tema soalan (question_theme)

Penerangan

Ia membolehkan anda menggunakan tema tersuai untuk soalan berkenaan.

Pilihan yang tersedia

• Tema soalan yang anda cipta, yang terletak di bawah Tema soalan dalam panel Tema.

Lihat: Tema soalan

Nota: Ciri ini sedang dalam pembangunan buat masa ini.

Lebar kotak input (text_input_width)

Penerangan

Atribut ini menetapkan lebar kotak input teks (iaitu "wrapper" bagi kotak input teks). Kotak input digunakan untuk memasukkan jawapan kepada (sub)soalan. Jika nilai lebar cukup tinggi, kotak input teks akan dipaparkan pada baris seterusnya. Sila ambil perhatian bahawa pilihan ini tidak menetapkan saiz input atau lebar keseluruhan lajur!

Pilihan yang tersedia

• Lalai: Jika dipilih, nilai lalai akan diperuntukkan kepada atribut ini supaya label dan kotak input teks yang sepadan berada pada baris yang sama. Sebagai contoh, jika lebar kotak input teks ialah 41%, nilai lebar kotak input teks akan menjadi nilai yang membolehkan label dan kotak input berada pada baris yang sama (58% dalam kes ini). Jika lebar kotak input teks melebihi 58%, kotak input teks akan dipaparkan pada baris seterusnya.
• 8%; 17%...92%, 100%: semakin besar nilai yang dipilih, semakin lebar kotak input teks.

Contoh

• Jika anda mahu bahagian input dipaparkan di bawah subsoalan/label, pilih pilihan 100% daripada senarai juntai bawah.

Sembunyikan tip (hide_tip)

Penerangan

Kebanyakan soalan lazimnya mengandungi tip yang berbunyi "Sila pilih salah satu pilihan berikut" atau teks petunjuk tentang cara mengisi soalan tersebut. Atribut ini membolehkan anda mematikan atau menghidupkan tip/petunjuk ini.

Tip/petunjuk ini termasuk mesej kriteria pengesahan (seperti bilangan jawapan min/maks, nilai jumlah min/maks/sama dengan). Jika hide_tip diaktifkan, mesej ini akan disembunyikan. Walau bagaimanapun, jika pengguna memasukkan data yang tidak sah, tip tersebut akan dipaparkan. Tip itu akan berwarna merah dan bertukar kepada hijau apabila kriteria pengesahan dipenuhi.

Pilihan yang tersedia

• Hidup - tip/petunjuk disembunyikan;
• Mati (lalai).

Saiz kotak input teks (input_box_size)

 Hint: This feature is available starting in version 3.0.0

Penerangan

Fungsi ini membolehkan anda menetapkan saiz kawasan teks (kotak input teks). Secara lalai, LimeSurvey memaparkan kotak input dengan saiz lalai. Tetapan ini boleh diatasi dengan menggunakan fungsi ini.

Untuk memindahkan kotak ke baris seterusnya, anda perlu menambah saiz pembungkus (wrapper). Untuk berbuat demikian, tingkatkan nilai atribut lebar input teks.

Nilai yang sah

• Sebarang nilai angka

Sentiasa sembunyikan soalan ini (hidden)

Penerangan

Jika diaktifkan, soalan akan sentiasa disembunyikan - soalan tersebut tidak akan dipaparkan kepada peserta-peserta soal selidik. Fungsi ini boleh digunakan dalam senario berikut:

• Jika anda ingin mengisi soalan terlebih dahulu melalui URL dan tidak mahu soalan itu dipaparkan pada skrin. Ini mengatasi sebarang syarat yang digunakan dalam tinjauan kerana soalan berkenaan tidak akan disertakan pada halaman.
• Jika anda ingin menyimpan atau mengira suatu nilai secara langsung melalui ExpressionScript - Penyampaian.

Nota: Jenis soalan biasa yang digunakan dengan fungsi ini ialah jenis Persamaan.

Pilihan yang tersedia

• Hidup
• Mati (lalai)

Kelas CSS (css_class)

Penerangan

Jika anda ingin menambah kelas CSS khas pada soalan tertentu, anda boleh memasukkan nama kelas CSS dalam kotak ini. Pastikan anda meninggalkan satu ruang kosong di antara nama kelas yang berbeza.

Nilai yang sah

• Sebarang rentetan teks dengan satu ruang di antara nama kelas CSS yang berbeza.

 Hint: Anda juga boleh memasukkan ungkapan dalam kotak ini ^{(New in 3.0.0 )}. Ingat bahawa output ungkapan tidak akan dikemas kini secara dinamik.

  Menurut W3C, nama kelas CSS hanya boleh mengandungi aksara [a-zA-Z, dan 0-9] serta aksara ISO 10646 U+00A1 dan ke atas, ditambah tanda sempang (-) dan garis bawah (_). Nama tersebut tidak boleh bermula dengan digit, atau tanda sempang diikuti digit. LimeSurvey mengekod kelas CSS, tetapi tidak membetulkannya sepenuhnya.

Bantuan kaitan untuk tinjauan boleh cetak (printable_survey_relevance_help)

Penerangan

Jika anda ingin mencetak tinjauan, anda juga boleh mencetak persamaan kaitan bagi setiap soalan. Namun, jika anda ingin memberikan penjelasan dan bukannya ungkapan pada borang bercetak, isikan kotak ini dengan teks penjelasan bagi persamaan kaitan tersebut.

Nilai sah

• Sebarang teks dan/atau nombor yang ingin anda paparkan pada borang boleh cetak.

Input

Huruf maksimum (maximum_chars)

Penerangan

Tetapan ini membolehkan anda menetapkan bilangan aksara maksimum yang boleh dimasukkan untuk soalan berasaskan teks. Memasukkan nilai, contohnya, 20 bermaksud peserta tidak boleh memasukkan lebih daripada 20 aksara.

Nilai sah

• Sebarang nilai integer lebih besar daripada 0

Nilai minimum input berangka (min_num_value_n)

Penerangan

Nilai minimum input berangka yang boleh dimasukkan oleh responden dalam kotak input.

Nilai sah

• Mana-mana nilai integer melebihi 0
• Mana-mana nombor
• Mana-mana kod SGQA
• Mana-mana kod soalan (nama pemboleh ubah)
• Mana-mana persamaan, menggunakan sintaks ExpressionScript, tanpa kurungan kerinting di sekelilingnya.

Hanya integer (num_value_int_only)

Penerangan

Jika didayakan, responden hanya boleh memasukkan nilai integer dalam kotak tersebut.

Pilihan yang tersedia

• Ya
• Tidak (lalai)

Nilai maksimum input berangka (max_num_value_n)

Penerangan

Nilai maksimum input berangka yang boleh dimasukkan oleh responden dalam kotak input.

Nilai yang sah

• Sebarang nilai integer melebihi 0
• Sebarang nombor
• Sebarang kod SGQA
• Sebarang kod soalan (nama pemboleh ubah)
• Sebarang persamaan, menggunakan sintaks ExpressionScript, tanpa kurungan kurawal di sekelilingnya.

Logik

Perawakan nama kumpulan (random_group)

Penerangan

Ia meletakkan soalan ke dalam kumpulan rawak yang ditetapkan, dan semua soalan dalam kumpulan yang ditetapkan itu akan dipaparkan dalam susunan rawak kepada responden tinjauan.

Anda boleh menemui contoh tinjauan yang menggunakan nama kumpulan rawak dalam contoh tinjauan ExpressionScript.

Nilai yang sah

Masukkan sahaja sebarang rentetan yang anda mahu (contohnya: 'group1'). Semua soalan yang menetapkan rentetan yang sama dalam kotak Perawakan nama kumpulan akan disusun secara rawak kedudukannya dalam tinjauan (=ditukar ganti secara rawak antara satu sama lain).

Pratonton Untuk pratonton soalan, gunakan fungsi Pratonton tinjauan dan bukannya Pratonton kumpulan soalan, kerana fungsi kedua dilaporkan tidak memaparkan soalan dalam susunan rawak.

Persamaan pengesahan soalan (em_validation_q)

Penerangan

Ini ialah persamaan yang digunakan untuk mengesahkan keseluruhan soalan (cth., semua bahagiannya secara kolektif bagi soalan berbilang jawapan). Jika soalan gagal memenuhi kriteria pengesahan, mesej em_validation_q_tip akan dipaparkan (ia menggunakan gaya CSS .error). Petua ini menggunakan gaya CSS .em_q_fn_validation, yang disembunyikan secara lalai dalam template.css.

Perbezaan utama antara ciri ini dengan persamaan pengesahan subsoalan (pilihan em_validation_sq) ialah bagi ciri ini, jika soalan (atau bahagian soalan) gagal pengesahan, mesej ralat boleh dipaparkan. Bagi pengesahan subsoalan, setiap sel kemasukan teks (cth., dalam jenis soalan tatasusunan, tetapi ia juga boleh digunakan pada jenis soalan kemasukan tunggal) akan digayakan supaya warna latar belakangnya menjadi merah (cerah).

Nilai sah

• Mana-mana persamaan yang menggunakan sintaks ExpressionScript, tanpa kurungan kerawang di sekelilingnya.

Contoh

• Anda ingin mengumpulkan maklumat demografi daripada pengguna melalui soalan Teks pendek berbilang, dan anda ingin mengesahkan bahawa pengguna telah memasukkan alamat e-mel dan nombor telefon yang sah.

Contoh ini menunjukkan rupa soalan dengan jawapan yang tidak sah:

Dan inilah rupanya dengan satu jawapan yang tidak sah:

Berikut ialah cara anda mengedit soalan untuk memasukkan maklumat tersebut:

Dan inilah sebahagian daripada output Show Logic File yang membolehkan anda menyemak ketepatan ungkapan anda dan memastikan tiada ralat sintaks:

Seperti yang anda lihat, persamaan pengesahan menguji bahawa kedua-dua e-mel dan nombor telefon sama ada kosong atau sepadan dengan penapis ekspresi lazim.

Petua pengesahan hanya memaparkan mesej amaran jika telefon atau e-mel kelihatan tidak sah.

 Hint: Untuk mencipta mesej pengesahan yang kompleks, baca tentang penggunaan ExpressionScript.

Jika anda ingin mengimport contoh di atas ke dalam pemasangan LimeSurvey anda, muat turun fail .lsq berikut: Em_validation_q_example.zip.

 Hint: Ingat, LimeSuvey menggunakan sintaks Perl untuk ekspresi lazim, jadi ia mesti bermula dan berakhir dengan / (aksara garis condong)!

Petua untuk persamaan pengesahan seluruh soalan (em_validation_q_tip)

Penerangan

Jika anda menggunakan persamaan pengesahan soalan, anda boleh menggunakan kotak ini untuk memaparkan mesej pilihan sebagai petua soalan tentang cara soalan tersebut perlu diisi.

Nilai sah

• Sebarang rentetan atau persamaan yang menggunakan sintaks ExpressionScript.

Contoh

Lihat contoh daripada bahagian wiki persamaan pengesahan soalan - contoh tersebut menunjukkan cara petua boleh disesuaikan untuk memaparkan bahagian mana dalam soalan teks pendek berbilang yang gagal memenuhi kriteria pengesahan.

Persamaan pengesahan subsoalan (em_validation_sq)

Penerangan

Ini ialah persamaan yang digunakan untuk mengesahkan setiap subsoalan (medan teks) secara individu. Mana-mana medan teks yang tidak lulus syarat pengesahan ini akan bertukar warna latar belakangnya kepada merah jambu (menggunakan gaya CSS .em_sq_fn_validation) untuk menyerlahkan ralat tersebut. Perhatikan bahawa ini disediakan sebagai tambahan kepada pilihan pengesahan berasaskan ekspresi lazim.

Nilai yang sah

Mana-mana persamaan yang menggunakan sintaks ExpressionScript, tanpa kurungan kurawan di sekelilingnya.

Contoh

Sebagai contoh, jika anda hanya mahu membenarkan nombor yang merupakan gandaan 3 sebagai jawapan, persamaannya ialah:

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

Pemboleh ubah terpelihara this digantikan secara automatik dengan rujukan kepada sel kemasukan teks yang aktif.

Tip untuk persamaan pengesahan sub-soalan (em_validation_sq_tip)

Penerangan

Jika anda menggunakan em_validation_sq, ini ialah mesej/tip pilihan yang akan dipaparkan jika jawapan yang dimasukkan tidak betul.

Nilai yang sah

• Sebarang rentetan

Contoh

• Meneruskan contoh pengesahan e-mel, tip tersebut mungkin berbunyi "Sila masukkan alamat e-mel yang sah."

Lain-lain

Sisipkan pemisah halaman dalam paparan boleh cetak (page_break)

Penerangan

Atribut ini hanya aktif apabila anda benar-benar mencetak tinjauan daripada Paparan Boleh Cetak. Atribut ini memaksa pemisah halaman sebelum soalan.

Pilihan yang tersedia

• Hidup
• Mati (lalai)

Statistik

Tunjuk didalam statistik awam (public_statistics)

Penerangan

Atribut ini membolehkan pentadbir tinjauan memilih sama ada keputusan soalan tertentu dipaparkan kepada peserta tinjauan selepas mereka menghantar tinjauan.

Nota: Untuk memaparkan statistik pada muka surat terakhir, jangan lupa dayakan fungsi ini daripada tetapan penyampaian & navigasi. Jika tidak, pautan statistik tidak akan dipaparkan pada akhir tinjauan anda.

Tetapan lalai bagi setiap soalan ialah 'Off' (= Jangan tunjukkan statistik soalan kepada responden). Anda perlu mendayakannya bagi setiap soalan jika anda ingin menunjukkan statistik tinjauan bagi soalan tersebut kepada peserta tinjauan selepas penghantaran tinjauan.

Pilihan yang tersedia

• On
• Off (lalai)

Papar carta (display_chart)

Penerangan

Atribut ini membolehkan pentadbir tinjauan memilih sama ada carta yang mengandungi keputusan soalan patut dipaparkan kepada peserta tinjauan selepas mereka melengkapkan tinjauan.

Nota: Untuk memaparkan carta pada muka surat terakhir, anda perlu mendayakan pilihan berikut:

• Tetapan tinjauan statistik awam daripada tetapan penyampaian & navigasi
• Tetapan tinjauan papar graf daripada tetapan penyampaian & navigasi
• atribut soalan statistik awam, dan
• atribut soalan papar carta.

Pilihan yang tersedia

• Hidup
• Mati (lalai)

Jenis carta (chart_type)

Penerangan

Atribut ini membolehkan pentadbir tinjauan memilih jenis carta yang akan dipaparkan kepada responden selepas beliau selesai mengisi tinjauan.

Nota: Jangan lupa untuk menukar tetapan soalan dan tetapan tinjauan supaya carta dipaparkan pada penghujung tinjauan. Untuk butiran lanjut, semak bahagian wiki mengenai atribut soalan Papar carta.

Pilihan yang tersedia

• Carta palang
• Carta pai
• Radar
• Garis
• PolarArea
• Doughnut