Тип вопроса - Длинный произвольный текст

Краткое описание

Этот тип вопроса позволяет собирать ответы в виде текста из нескольких строк.

Пример: 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, без окружающих фигурных скобок.

Пример

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

В этом примере показано, как выглядит вопрос при неверных ответах:

А так он выглядит при одном неверном ответе:

Вот как нужно редактировать вопрос, чтобы ввести эту информацию:

А это часть вывода файла логики, которая позволяет проверить правильность выражения и убедиться, что в нём нет синтаксических ошибок:

Как видите, уравнение проверки проверяет, что и адрес e-mail, и номер телефона либо пусты, либо соответствуют фильтру на основе регулярного выражения.

Подсказка по проверке показывает предупреждение только в том случае, если телефон или e-mail выглядят неверными.

 Hint: Чтобы создавать сложные сообщения проверки, прочитайте об использовании ExpressionScript.

Если вы хотите импортировать приведённый выше пример в свою установку LimeSurvey, скачайте следующий файл .lsq: Em_validation_q_example.zip.

 Hint: Помните, что LimeSurvey использует синтаксис регулярных выражений 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, это необязательное сообщение или подсказка, которая будет показана, если введённый ответ неверен.

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

• Любая строка

Пример

• Продолжая пример проверки адресов e-mail, подсказка может быть такой: «Пожалуйста, введите допустимые адреса e-mail».

Другое

Вставить разрыв страницы в печатную версию (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_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 или, по крайней мере, значение меньше того, которое используется в атрибуте 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