Actions

Question type - Huge free text/en: Difference between revisions

From LimeSurvey Manual

(Importing a new version from external source)
(Importing a new version from external source)
Line 34: Line 34:
{{QS:maximum_chars}}
{{QS:maximum_chars}}


{INCLUDE(page="Advanced question settings",start="!random_group",stop="---")}{INCLUDE}
{{QS:Random_group}}


{INCLUDE(page="Advanced question settings",start="!page_break",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!page_break",stop="---")}{INCLUDE}

Revision as of 05:24, 13 June 2013

Short description

This question type collect multiple lines of text input, and is wider than the long free text type.


Core settings

Mandatory

Description

This option allows the survey administrators to request their respondents to answer certain survey questions. If the mandatory questions are not answered, the respondents will not be able to proceed further. If you have a question with multiple subquestions, and you require only certain subquestions to be answered, use the minimum answer attribute located under the Logic tab.

If you use any of the preinstalled themes and the mandatory question attribute is enabled, a red asterisk will be shown next to the question. If you wish to hide it, please check these instructions.


Available options

  • On - Question must be answered before the participant can proceed to the next page - the answer option 'No answer' is never shown.
  • Soft - If the question is not answered, a warning is shown when trying to proceed to the next page - however, the participant can choose to ignore the warning and proceed. Note that the 'No answer' option is still shown (if activated in survey presentation settings)
  • Off (default) - Question can be left unanswered


Validation (using regular expressions) (preg_validation)

Description

This option lets you specify a regular expression with which you can validate all the parts of a question.

If any question or subquestion value does not meet the validation requirements, the background colour of the text entry field will be changed to red so that users can easily see which parts of the question need to be corrected. Thus, you can do on-page validation. In this way you will not need to wait for the user to click on the submit button to validate the respective question.

Valid values

  • Any valid regular expression

Example


These Core Settings are available in Version 1.92 and beyond

QS:Defaults


Condition (previously "Relevance equation")

Description

If the result value of the condition is "1" or "true", the question is "relevant" in the survey context, i.e. it is shown to the survey participant. If not, the question is hidden. Any survey question allows you to specify a relevance equation. This function is the successor of conditions and supports much more complex conditional logic.

Syntax Highlighting

Whenever you save the condition, it is evaluated and syntax-highlighted. Any errors will be color coded so that you can quickly detect and fix them.

 Hint: To check if all conditions are used correctly within your survey, read about our show logic file feature.


Valid values

  • Any condition that makes use of the ExpressionScript syntax, without surrounding curly braces.

Examples

Here are good examples of syntax highlighting.


Advanced settings

Input box width (text_input_width)

Description

This attribute sets the width of the text input boxes (of the "wrapper" of the text input boxes). The input box is used to introduce an answer to the (sub)question. If the value of the width is sufficiently high, then the text input box will be displayed on the next line. Please note that this option does not set the size of the input or the width of the entire column!

Available options

  • Default: If selected, a default value will be allocated to this attribute in such a way to have both the label and its corresponding text input box on the same line. For example, if the text input box width is 41%, the value of the width of the text input box will be a value that allows both the label and the input box on the same line (58% in this case). If the width of text input box was higher than 58%, then the text input box would be displayed on the next line.
  • 8%; 17%...92%, 100%: the bigger the selected value, the larger the width of the text input box.

Example

  • If you wish to have the input part displayed below the subquestion/label, select the 100% option from the dropdown list.



Display rows (display_rows)

Description

It sets the number of rows that are displayed without making use of the scroll bar to check all the content. If there are more rows than the number mentioned in this field, then a scroll bar will be displayed. The default value for the "Long free text" question type is 5, while for the "Huge free text question type" is 30.

Valid values

  • Any positive integer number greater than 0



Always hide this question (hidden)

Description

If enabled, the question will always be hidden - it will not be displayed to the survey participants. This function can be used in the following scenarios:

  • If you wish to prefill a question with a URL and you want not to have it displayed on the screen. This overrides any conditions used within the survey because the respective question will not even be embedded on the page.
  • If you wish to store or calculate a value on the fly via the ExpressionScript - Presentation.
Note: A common question type that is used with this function is the Equation one.

Available options

  • On
  • Off (default)



Maximum characters (maximum_chars)

Description

This allows you to set the maximum number of characters that can be entered for a text based question. Entering a value of, say, 20 will mean that the participant cannot enter any more than 20 characters.

Valid values

  • Any integer value above 0



Randomization group name (random_group)

Description

It places the questions into a specified randomization group, all questions included in the specified group being displayed in a random order to the survey respondents.

You can find a sample survey using randomization group name in ExpressionScript sample survey.

Valid values

Just enter any string you like (for example: 'group1'). All question which have set the same string within the randomization group name box will have their place in the survey randomized (=randomly exchanged among each other).


Preview To preview the questions use the preview survey instead of the preview question group function, as the second has been reported to not show the questions in a randomized order.


{INCLUDE(page="Advanced question settings",start="!page_break",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_action",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_disable_next",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_disable_prev",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_countdown_message",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_timer_style",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_message_delay",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_message",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_message_style",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_warning",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_warning_display_time",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_warning_message",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!time_limit_warning_style",stop="---")}{INCLUDE}

These Advanced Settings are available in Version 1.92 and beyond

{INCLUDE(page="Advanced question settings",start="!em_validation_q",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!em_validation_q_tip",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!em_validation_sq",stop="---")}{INCLUDE}

{INCLUDE(page="Advanced question settings",start="!em_validation_sq_tip",stop="---")}{INCLUDE}