Тип питання - Числове введення

Короткий опис

Цей тип питання просить учасника опитування ввести одне число.

Приклад: Question_example_numerical_input.zip.

Загальні параметри

Обов'язково

Опис

Цей параметр дозволяє адміністраторам опитування вимагати від респондентів відповіді на певні питання опитування. Якщо на обов'язкові питання не надано відповіді, респонденти не зможуть перейти далі. Якщо у вас є питання з кількома підпитаннями і потрібно, щоб відповіді були надані лише на певні підпитання, скористайтеся атрибутом мінімум відповідей, розташованим на вкладці Логіка.

Якщо ви використовуєте будь-яку з попередньо встановлених тем і атрибут питання обов'язково увімкнено, поруч із питанням відображатиметься червона зірочка. Якщо ви хочете її приховати, ознайомтеся з цими інструкціями.

Доступні варіанти

• Увімк. - на питання потрібно відповісти, перш ніж учасник зможе перейти на наступну сторінку - варіант відповіді «Немає відповіді» ніколи не відображається.
• М'яко - якщо на питання не надано відповіді, при спробі перейти на наступну сторінку відображається попередження - однак учасник може проігнорувати попередження і продовжити. Зверніть увагу, що варіант «Немає відповіді» все одно відображається (якщо його активовано в налаштуваннях презентації опитування)
• Вимк. (за замовчуванням) - питання можна залишити без відповіді

Перевірка (за допомогою регулярних виразів) (preg_validation)

Опис

Цей параметр дає змогу вказати регулярний вираз, за допомогою якого можна перевірити всі частини питання.

Якщо будь-яке значення питання або підпитання не відповідає вимогам перевірки, колір фону поля для введення тексту зміниться на червоний, щоб користувачі могли легко побачити, які частини питання потрібно виправити. Таким чином, можна виконувати перевірку на самій сторінці. Так вам не потрібно буде чекати, поки користувач натисне кнопку «Надіслати», щоб перевірити відповідне питання.

Допустимі значення

• Будь-який допустимий регулярний вираз

Приклад

• Натисніть тут, щоб переглянути кілька прикладів.

Умова

Опис

Якщо результатом умови є значення "1" або "true", питання є "релевантним" у контексті опитування, тобто воно відображається учаснику опитування. В іншому випадку питання приховується. Для будь-якого питання опитування можна вказати рівняння релевантності. Ця функція є наступницею умов і підтримує набагато складнішу умовну логіку.

Підсвічування синтаксису

Щоразу, коли ви зберігаєте умову, вона перевіряється, а її синтаксис підсвічується. Усі помилки позначаються кольором, щоб ви могли швидко їх виявити та виправити.

 Hint: Щоб перевірити, чи правильно використано всі умови у вашому опитуванні, прочитайте про нашу функцію показу файлу логіки.

Допустимі значення

• Будь-яка умова, що використовує синтаксис ExpressionScript, без обрамлення фігурними дужками.

Приклади

Ось хороші приклади підсвічування синтаксису.

Відображення

Префікс (prefix)

Опис

Текстове значення, яке відображається як префікс перед полем (полями) введення тексту. Префікс відображається безпосередньо ліворуч від поля введення.

Якщо екран малий, префікс буде відображатися над полем введення. Якщо ви хочете залишити його ліворуч ^{(New in 3.0.0 )} : додайте до питання клас suffix-prefix-force.

Допустимі значення

• Будь-який символ або набір символів, які ви хочете відобразити перед полем введення

Приклад

Якщо ввести для цього атрибута значення "$", знак долара відображатиметься безпосередньо перед полем введення тексту.

Суфікс (suffix)

Опис

Текстове значення, яке додається як суфікс до поля введення тексту. Суфікс відображається одразу праворуч від поля введення.

На малому екрані суфікс відображається під полем введення. Якщо ви хочете залишити його праворуч ^{(New in 3.0.0 )}, додайте до питання клас suffix-prefix-force.

Допустимі значення

• Будь-який символ або набір символів, які ви хочете відобразити після поля введення

Приклад

Якщо ввести для цього атрибута значення "%", одразу після поля введення тексту буде відображено знак відсотка.

Тема питання (question_theme)

Опис

Дозволяє використовувати налаштовані теми для відповідного питання.

Доступні опції

• Створені вами теми питань, які розташовані в розділі Теми питань на панелі Теми.

Див.: Теми питань

Примітка: Ця функція наразі перебуває в розробці.

Ширина поля введення (text_input_width)

Опис

Цей атрибут задає ширину полів для введення тексту (так званої «обгортки» полів для введення тексту). Поле введення використовується для введення відповіді на питання або підпитання. Якщо значення ширини достатньо велике, поле для введення тексту відображатиметься на наступному рядку. Зверніть увагу, що цей параметр не задає розмір поля введення або ширину всього стовпця!

Доступні параметри

• Стандартне значення: якщо вибрано, цьому атрибуту буде призначено значення за умовчанням таким чином, щоб і мітка, і відповідне їй поле для введення тексту розташовувалися в одному рядку. Наприклад, якщо ширина мітки становить 41%, значення ширини поля для введення тексту буде таким, що дозволяє розмістити в одному рядку і мітку, і поле введення (у цьому випадку 58%). Якщо ширина поля для введення тексту перевищуватиме 58%, воно відображатиметься на наступному рядку.
• 8%; 17%...92%, 100%: чим більше вибране значення, тим більша ширина поля для введення тексту.

Приклад

• Якщо ви хочете, щоб поле введення відображалося під підпитанням або міткою, виберіть значення 100% у випадному списку.

Сховати підказку (hide_tip)

Опис

Більшість питань зазвичай містять підказку на кшталт «Будь ласка, оберіть один із наведених варіантів» або текст-підказку про те, як заповнити питання. Цей атрибут дає змогу вимкнути або ввімкнути такі підказки.

Ці підказки містять повідомлення про критерії перевірки (наприклад, мінімальну/максимальну кількість відповідей, мінімальне/максимальне значення суми або значення, що дорівнює сумі). Якщо hide_tip увімкнено, ці повідомлення буде приховано. Однак якщо користувач введе некоректні дані, підказки з’являться. Вони будуть червоного кольору і зміняться на зелений, щойно критерії перевірки буде виконано.

Доступні варіанти

• Увімк. — підказки приховано;
• Вимк. (за замовчуванням).

Розмір поля введення тексту (input_box_size)

 Hint: This feature is available starting in version 3.0.0

Опис

Ця функція дає змогу задати розмір текстової області (поля введення тексту). За замовчуванням LimeSurvey примусово відображає поле введення зі стандартним розміром. Це можна змінити за допомогою цієї функції.

Щоб перемістити поле на наступний рядок, потрібно збільшити розмір обгортки. Для цього збільште значення атрибута ширини поля введення тексту.

Допустимі значення

• Будь-яке числове значення

Завжди ховати це запитання (hidden)

Опис

Якщо цей параметр увімкнено, питання завжди буде приховане — його не буде показано учасникам опитування. Цю функцію можна використовувати в таких випадках:

• Якщо ви хочете попередньо заповнити питання через URL і не хочете, щоб воно відображалося на екрані. Це перевизначає всі умови, використані в опитуванні, оскільки відповідне питання взагалі не буде вбудовано на сторінку.
• Якщо ви хочете зберегти або обчислити значення «на льоту» за допомогою ExpressionScript — презентація.

Примітка: Поширений тип питання, який використовується з цією функцією, — Рівняння.

Доступні параметри

• Увімкнено
• Вимкнено (за замовчуванням)

CSS-клас (css_class)

Опис

Якщо ви хочете додати спеціальні CSS-класи до певних питань, введіть назву (назви) CSS-класу в це поле. Обов’язково розділяйте різні назви класів пробілом.

Допустимі значення

• Будь-який текстовий рядок із пробілом між різними назвами CSS-класів.

 Hint: Ви також можете вставити в це поле вираз ^{(New in 3.0.0 )}. Пам’ятайте, що результат виразу не оновлюватиметься динамічно.

  Згідно з W3C, назви CSS-класів можуть містити лише символи [a-zA-Z та 0-9], символи ISO 10646 від U+00A1 і вище, а також дефіс (-) і підкреслення (_). Вони не можуть починатися з цифри або з дефіса, за яким іде цифра. LimeSurvey кодує CSS-класи, але не виправляє цього повністю.

Довідка з релевантності для друкованого опитування (printable_survey_relevance_help)

Опис

Якщо ви хочете надрукувати опитування, можна також надрукувати рівняння релевантності для кожного питання. Якщо ж ви бажаєте, щоб у друкованій формі замість виразу відображалося пояснення, заповніть це поле текстовим поясненням рівняння релевантності.

Допустимі значення

• Будь-який текст та/або числа, які ви хочете відобразити у друкованій формі.

Введення

Максимальна кількість символів (maximum_chars)

Опис

Дає змогу встановити максимальну кількість символів, які можна ввести для питання текстового типу. Наприклад, якщо ввести значення 20, учасник не зможе ввести більше 20 символів.

Допустимі значення

• Будь-яке ціле число більше 0

Мінімальне значення для чисельного вводу (min_num_value_n)

Опис

Мінімальне значення числового вводу, яке респондент може ввести в поле введення.

Допустимі значення

• Будь-яке ціле значення більше 0
• Будь-яке число
• Будь-який код SGQA
• Будь-який код питання (назва змінної)
• Будь-яке рівняння із використанням синтаксису ExpressionScript без обрамлення фігурними дужками.

Тільки ціле (num_value_int_only)

Опис

Якщо ввімкнено, респонденти зможуть вводити в поле лише цілі числа.

Доступні опції

• Так
• Ні (за замовчуванням)

Максимальне значення для чисельного вводу (max_num_value_n)

Опис

Максимальне числове значення, яке респондент може ввести в полі введення.

Допустимі значення

• Будь-яке ціле значення більше 0
• Будь-яке число
• Будь-який код SGQA
• Будь-який код запитання (назва змінної)
• Будь-яке рівняння із синтаксисом ExpressionScript, без обрамлювальних фігурних дужок.

Логіка

Назва групи рандомізації (random_group)

Опис

Розміщує питання в указану групу рандомізації. Усі питання, що входять до цієї групи, показуються респондентам опитування у випадковому порядку.

Приклад опитування з використанням назви групи рандомізації можна знайти в прикладі опитування ExpressionScript.

Допустимі значення

Просто введіть будь-який рядок (наприклад: 'group1'). Усі питання, для яких у полі назви групи рандомізації указано однаковий рядок, матимуть випадково впорядковане розташування в опитуванні (=випадково змінюватимуться місцями між собою).

Попередній перегляд Щоб переглянути питання, використовуйте функцію попередній перегляд опитування замість функції попередній перегляд групи питань, оскільки, за повідомленнями, остання не показує питання у випадковому порядку.

Рівняння перевірки питання (em_validation_q)

Опис

Це рівняння, яке використовується для перевірки всього питання (наприклад, усіх його частин разом для питання з кількома відповідями). Якщо питання не відповідає критеріям перевірки, буде показано повідомлення em_validation_q_tip (воно використовує CSS-стиль .error). Ця підказка використовує CSS-стиль .em_q_fn_validation, який за замовчуванням приховано у файлі template.css.

Головна відмінність між цією функцією та рівняннями перевірки підпитань (параметр em_validation_sq) полягає в тому, що для цієї функції, якщо питання (або його частини) не проходить перевірку, може бути показано повідомлення про помилку. Для перевірки підпитань кожну комірку введення тексту (наприклад, у типі питання «масив», але це також можна застосувати до типів питань з одним полем введення) буде позначено (світло-)червоним кольором фону.

Допустимі значення

• Будь-яке рівняння, що використовує синтаксис ExpressionScript, без оточуючих фігурних дужок.

Приклад

• Ви хочете зібрати демографічну інформацію від користувачів за допомогою питання «Кілька коротких текстів» і перевірити, що користувач ввів дійсну електронну адресу та номер телефону.

Цей приклад показує, як виглядає питання з недійсними відповідями:

А ось як воно виглядає з однією недійсною відповіддю:

Ось як потрібно редагувати питання, щоб ввести цю інформацію:

А ось частина виводу Показати файл логіки, яка дає змогу перевірити правильність вашого виразу та переконатися, що в ньому немає синтаксичних помилок:

Як видно, рівняння перевірки визначає, що електронна адреса та номер телефону або порожні, або відповідають фільтру регулярного виразу.

Підказка перевірки показує попередження лише тоді, коли телефон або електронна адреса виглядає недійсною.

 Hint: Щоб створити складні повідомлення перевірки, прочитайте про використання ExpressionScript.

Якщо ви хочете імпортувати наведений вище приклад у вашу інсталяцію LimeSurvey, завантажте такий файл .lsq: Em_validation_q_example.zip.

 Hint: Пам’ятайте, що LimeSuvey використовує синтаксис Perl для регулярних виразів, тому вони повинні починатися та закінчуватися символом / (скісна риска)!

Підказка для рівняння перевірки всього питання (em_validation_q_tip)

Опис

Якщо ви використовуєте рівняння перевірки питання, за допомогою цього поля можна відобразити необов'язкове повідомлення як підказку до питання про те, як потрібно його заповнити.

Допустимі значення

• Будь-який рядок або рівняння, що використовує синтаксис ExpressionScript.

Приклад

Перегляньте приклад у розділі вікі про рівняння перевірки питання — він показує, як можна налаштувати підказку, щоб вона показувала, які частини питання типу «Кілька коротких текстів» не відповідають критеріям перевірки.

Рівняння перевірки підпитання (em_validation_sq)

Опис

Це рівняння, яке використовується для окремої перевірки кожного підпитання (текстового поля). Колір фону будь-якого текстового поля, яке не відповідає цим умовам перевірки, змінюється на рожевий (за допомогою CSS-стилю .em_sq_fn_validation), щоб виділити помилку. Зверніть увагу, що ця можливість доступна на додаток до перевірки на основі регулярного виразу.

Допустимі значення

Будь-яке рівняння, що використовує синтаксис ExpressionScript, без обрамлювальних фігурних дужок.

Приклади

Наприклад, якщо ви хочете дозволити як відповіді лише числа, кратні 3, рівняння буде таким:

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

Зарезервована змінна this автоматично замінюється посиланням на активну клітинку введення тексту.

Підказка для рівняння перевірки підпитання (em_validation_sq_tip)

Опис

Якщо ви використовуєте em_validation_sq, це необов’язкове повідомлення/підказка, яка відображатиметься, якщо введена відповідь неправильна.

Допустимі значення

• Будь-який рядок

Приклад

• Продовжуючи приклад перевірки електронних адрес, підказка може бути такою: «Введіть дійсні електронні адреси.»

Інше

Вставити розрив сторінки у вигляді для друку (page_break)

Опис

Цей атрибут активний, лише коли ви друкуєте опитування з вигляду для друку. Він примусово вставляє розрив сторінки перед питанням.

Доступні варіанти

• Увімк.
• Вимк. (за замовчуванням)

Статистика

Показати у загальнодоступній статистиці (public_statistics)

Опис

Цей атрибут дозволяє адміністратору опитування обрати, чи слід показувати результати певного питання учасникам опитування після того, як вони завершили опитування.

Примітка: Щоб статистика відображалася на останній сторінці, не забудьте ввімкнути цю функцію в розділі налаштування презентації та навігації. Інакше посилання на статистику наприкінці опитування не відображатиметься.

Типове значення для кожного питання — 'Off' (= не показувати статистику питання респондентам). Потрібно ввімкнути цей параметр для кожного окремого питання, якщо ви хочете показувати статистику опитування за цим питанням (цими питаннями) учасникам опитування після завершення опитування.

Доступні варіанти

• Увімк.
• Вимк. (типово)

Відобразити графік (display_chart)

Опис

Цей атрибут дозволяє адміністратору опитування вибрати, чи слід показувати учасникам опитування діаграму з результатами питання після заповнення опитування.

Примітка: Щоб діаграма відображалася на останній сторінці, потрібно ввімкнути такі параметри:

• налаштування опитування Публічна статистика у розділі Налаштування презентації та навігації
• налаштування опитування Показувати графіки у розділі Налаштування презентації та навігації
• атрибут питання «Публічна статистика» та
• атрибут питання «Відобразити графік».

Доступні варіанти

• Увімк.
• Вимк. (за замовчуванням)

Тип діаграми (chart_type)

Опис

Цей атрибут дозволяє адміністратору опитування вибрати тип діаграми, яка відображатиметься респонденту після завершення заповнення опитування.

Примітка: Не забудьте змінити налаштування питання та налаштування опитування, щоб діаграми відображалися в кінці опитування. Докладніше читайте в розділі вікі про атрибут питання «Відобразити графік (діаграму)».

Доступні параметри

• Гістограма
• Кругова діаграма
• Радарна діаграма
• Лінійна діаграма
• Полярна діаграма
• Кільцева діаграма