Тип вопроса - Числовой ввод

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

Этот тип вопроса предлагает участнику опроса ввести одно число.

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

Пример

• Вы хотите собрать демографическую информацию о пользователях с помощью вопроса типа «Несколько коротких текстов» и проверить, что пользователь ввёл корректный адрес 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)

Описание

Этот атрибут активен только при фактической печати опроса из печатной версии. Он принудительно вставляет разрыв страницы перед вопросом.

Доступные варианты

• Вкл.
• Выкл. (по умолчанию)

Статистика

Показать в общедоступной статистике (public_statistics)

Описание

Этот атрибут позволяет администратору опроса выбрать, должны ли результаты по определённому вопросу отображаться участникам опроса после отправки ими анкеты.

Примечание: Чтобы статистика отображалась на последней странице, не забудьте включить эту функцию в разделе Настройки внешнего вида и навигации. В противном случае ссылка на статистику в конце опроса отображаться не будет.

По умолчанию для каждого вопроса установлено значение «Выкл.» (=не показывать статистику вопроса респондентам). Эту настройку необходимо включить для каждого отдельного вопроса, если вы хотите показывать участникам опроса статистику по этим вопросам после отправки опроса.

Доступные варианты

• Вкл.
• Выкл. (по умолчанию)

Показывать график (display_chart)

Описание

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

Примечание: Чтобы график отображался на последней странице, необходимо включить следующие параметры:

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

Доступные варианты

• Вкл
• Выкл (по умолчанию)

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

Описание

Этот атрибут позволяет администратору опроса выбрать, какой тип диаграммы будет показан респонденту после заполнения опроса.

Примечание: Не забудьте изменить настройки вопроса и настройки опроса, чтобы диаграммы отображались в конце опроса. Подробнее см. в разделе вики об атрибуте вопроса «Показывать график».

Доступные варианты

• Столбчатая диаграмма
• Круговая диаграмма
• Радар
• Линия
• Полярная диаграмма
• Кольцевая диаграмма