Тип питання - Довгий довільний текст

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

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

Приклад: Long_free_text_example.zip

Загальні опції

Обов'язково

Опис

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

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

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

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

Умова

Опис

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

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

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

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

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

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

Приклади

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

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

Опис

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

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

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

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

Приклад

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

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

Показати рядки (display_rows)

Опис

Визначає кількість рядків, які відображаються без використання смуги прокручування для перегляду всього вмісту. Якщо рядків більше, ніж зазначено в цьому полі, відобразиться смуга прокручування. Стандартне значення для типу питання "Довгий довільний текст" дорівнює 5, а для типу питання "Величезний довільний текст" — 30.

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

• Будь-яке додатне ціле число, більше за 0

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

Опис

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

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

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

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

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

Опис

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

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

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

Приклад

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

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

 Hint: This feature is available starting in version 3.0.0

Опис

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

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

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

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

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

Опис

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

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

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

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

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

Завжди ховати це запитання (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-класи, але не виправляє цього повністю.

Введення

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

Опис

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

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

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

Логіка

Назва групи рандомізації (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)

Опис

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

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

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

Статистика

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

Опис

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

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

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

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

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

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

Опис

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

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

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

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

Таймер

Часове обмеження (time_limit)

Опис

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

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

• Будь-яке додатне ціле число

Приклад

Встановіть значення 240, щоб відлік тривав 4 хвилини (240 секунд).

<onlyinclude>

Дія часового ліміту (time_limit_action)

Опис

Визначає дію, яка виконується після завершення time_limit. За замовчуванням для часового обмеження встановлено дію "Попередіть та рухайтесь далі": система показує коротке попередження про завершення часу, зберігає відповідь на питання та автоматично натискає "Далі >>". Альтернативні варіанти:

• "Продовжувати без попередження" — автоматично натискає кнопку "Далі >>" після завершення таймера, але без жодного попередження.
• "Лише заборонити" — блокує зміни у питанні, тож учасник не може нічого змінити, але кнопка "Далі >>" автоматично не натискається.

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

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

• Попередіть та рухайтесь далі (за замовчуванням): попередить учасника про завершення часу, а потім натисне кнопку «Далі»
• Продовжувати без попередження: одразу натисне кнопку «Далі» після завершення часового обмеження
• Лише заборонити: заблокує відповідь після завершення часового обмеження, але кнопку «Далі» автоматично не натискатиме

Додаткова інформація

  Якщо питання є обов'язковим або обов'язковим є питання в групі, то за відсутності відповіді на обов'язкові питання буде створено цикл JavaScript. У результаті на екрані з'явиться помилка про те, що певні питання не заповнено, що, своєю чергою, спричинить оновлення сторінки.
Замість обов'язкових питань можна використовувати вирази (докладніше про рівняння перевірки для питань і підпитань), щоб користувач не залишав поля відповідей порожніми. Щоб побачити, як працюють рівняння перевірки, перегляньте наступний приклад.

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

Позбавити часового обмеження наступне (time_limit_disable_next)

Опис

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

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

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

• Увімк. - Кнопка «Далі» буде вимкнена, доки не завершиться зворотний відлік часового обмеження.
• Вимк. (за замовчуванням)

Примітка: Якщо ваше опитування використовує формат «Група за Групою», ця функція застосовується до всієї групи, до якої належить це питання.

Позбавити часового обмеження попереднє (time_limit_disable_prev)

Опис

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

Це налаштування застосовується, лише якщо активовано загальне налаштування Часове обмеження.

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

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

Примітка: Якщо ваше опитування використовує формат «Група за Групою», ця функція застосовується до всієї групи, до якої належить це питання.

Повідомлення таймера зворотнього відліку (time_limit_countdown_message)

Опис

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

Стиль CSS для таймеру часового ліміту (time_limit_timer_style)

Опис

Цей атрибут дозволяє задати CSS-стиль для відображення таймера зворотного відліку (і перевизначає стиль за замовчуванням). Якщо атрибут не заповнено, використовується стиль за замовчуванням: 'width: 150px; margin-left: auto; margin-right: auto; border: 1px solid #111; text-align: center; background-color: #EEE; margin-bottom: 5px; font-size: 8pt;'.

Будь-який текст, введений в цей атрибут, повністю замінить стиль CSS за замовчуванням, тому будьте уважні, вводячи значення. Простий спосіб приховати таймер — скопіювати стиль за замовчуванням в цей атрибут і додати 'display: none;' в кінці.

Це налаштування застосовується, лише якщо активовано загальне налаштування часового обмеження.

Повідомлення про закінчення часового обмеження відображення часу (time_limit_message_delay)

Опис

Цей атрибут визначає, скільки секунд відображається time_limit_message перед виконанням time_limit_action. Якщо цей атрибут не встановлено, використовується значення за замовчуванням 1 (1 секунда).

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

Приклад

time_limit_message_delay: 5 = повідомлення відображається протягом 5 секунд

Повідомлення про закінчення часового обмеження (time_limit_message)

Опис

Це текст повідомлення, яке з’являється учаснику, коли time_limit закінчився. За замовчуванням це повідомлення має вигляд «Ваш час, щоб відповісти на це питання вже закінчився». Якщо атрибут time_limit_action встановлено на «Продовжувати без попередження», це повідомлення не відображається. Ви можете задати CSS-стиль для цього тексту в атрибуті time_limit_message_style (див. нижче).

Це налаштування застосовується лише якщо активовано загальні налаштування часового обмеження.

Приклад

time_limit_message: Час на відповідь на це питання минув.

Повідомлення про часове обмеження Стиль CSS (time_limit_message_style)

Опис

Дає змогу задати (і перевизначає стандартний) CSS-стиль, який використовується для відображення повідомлення про часове обмеження. Якщо значення цього атрибута не задано, використовується стандартне значення стилю: 'top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: white; z-index: 1002; text-align: center; overflow: auto'.

Будь-який текст, введений в цей атрибут, повністю замінює стандартний CSS-стиль, тому будьте уважні, вводячи значення для цього атрибута. Наполегливо рекомендуємо повторно використовувати значення z-index або, принаймні, задати значення z-index вище, ніж у атрибута time_limit_warning_message_style (за замовчуванням 1001).

Приклад

Встановіть значення: top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: black; color: white; z-index: 1010; text-align: center; overflow: auto

Таймер повідомлення-попередження про часове обмеження (time_limit_warning)

Опис

За допомогою цього атрибута можна встановити час (у секундах), за який до завершення часового обмеження буде показано time_limit_warning_message. Встановлення значення для цього атрибута активує повідомлення-попередження про часове обмеження.

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

Приклад

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

Час відображення повідомлення-попередження про обмеження часу (time_limit_warning_display_time)

Опис

Визначає, як довго повідомлення time_limit_warning_message відображається на екрані, перш ніж воно буде прибране/приховане. За замовчуванням, якщо з’являється повідомлення time_limit_warning_message, воно залишається видимим, доки таймер зворотного відліку не завершить відлік. Якщо в це поле введено значення, більше нуля, повідомлення буде приховано після вказаної кількості секунд.

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

Приклад

time_limit_warning_display_time: 10 = повідомлення-попередження про обмеження часу зникне через 10 секунд після його появи.

Повідомлення з попередженням про обмеження часу (time_limit_warning_message)

Опис

Якщо налаштовано, відображає текст попередження, яке показується протягом певного проміжку часу до завершення обмеження часу. Текст за замовчуванням: «Час для відповіді на це питання майже вичерпано. Залишилося {TIME}.» {TIME} замінюється відформатованим описом залишку часу (наприклад, «30 секунд», «1 хвилина або 5 секунд»). Це повідомлення відображається лише за наявності атрибута time_limit_warning. За допомогою атрибута time_limit_warning можна задати, коли з’являється повідомлення (time_limit_warning_message).

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

Приклад

Увага: через {TIME} час на відповідь на питання закінчиться.

CSS-стиль попередження про часове обмеження (time_limit_warning_style)

Опис

Дає змогу задати (і перевизначити стандартний) CSS-стиль, який використовується для відображення попередження про часове обмеження. Якщо значення не задано, для цього атрибута використовується стандартне значення стилю: 'top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: white; z-index: 1001; text-align: center; overflow: auto'.

Будь-який текст, введений в цей атрибут, повністю замінить стандартний CSS-стиль повідомлення-попередження, тому будьте уважні, вводячи значення для цього атрибута. Наполегливо рекомендуємо повторно використати значення z-index або, принаймні, задати значення z-index меншим за те, що використовується в атрибуті time_limit_message_style (за замовчуванням 1002).

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

Приклад

top: 10px; left: 35%; width: 30%; height: 60px; padding: 16px; border: 8px solid #555; background-color: gray; color: white; z-index: 1001; text-align: center; overflow: auto