Question type - Short free text
From LimeSurvey Manual
Short description
This question type collects a single line of text input.
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.
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
If the map is enabled as a google map, and the question is set to mandatory, the survey user must move the red point, or enter the Lat/Long text box. The user may not merely rely on the default, and hit the "NEXT" button. It is recommended that you so advise in the substance of the question text.
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
- Click here to check multiple examples.
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.
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
Prefix (prefix)
Description
A text value to be shown as prefix before the text input box(es). The prefix is shown just left of the input.
If the screen is small, then the prefix will be displayed above the input. If you want to leave it on the left (New in 3.0.0 ) : add suffix-prefix-force class to the question.
Valid values
- Any character or set of characters you wish to be displayed before the input
Example
Entering a value of "$" for this attribute would result in a dollar sign being displayed immediately preceding the text input box.
Suffix (suffix)
Description
A text value to be suffixed to a text entry box. The sufix is shown just right of the input.
On little screen : sufix is shown below the input. If you want to leave it at right (New in 3.0.0 ) : add suffix-prefix-force class to the question.
Valid values
- Any character or set of characters you wish to be displayed after the input
Example
Entering a value of "%" for this attribute would result in a percentage sign being displayed immediately after the text input box.
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
{INCLUDE(page="Advanced question settings",start="!text_input_width",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!hidden",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!maximum_chars",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!random_group",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!location_mapservice",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!location_nodefaultfromip",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!location_country",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!location_city",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!location_state",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!location_postal",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!location_defaultcoordinates",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!location_mapzoom",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!location_mapwidth",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!location_mapheight",stop="---")}{INCLUDE}
{INCLUDE(page="Advanced question settings",start="!numbers_only",stop="---")}{INCLUDE}
{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}
{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}