Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
en:create:functions:question [12.07.2016 14:25] – admin | en:create:functions:question [29.09.2020 16:46] – [question()] sophia.schauer |
---|
====== question() ====== | ====== question() ====== |
| |
''void **question**(string //questionID//, array|string //items//, [string //options//])'' | ''void **question**(string|array //questionID//, array|string //items//, [string //options//])'' |
| |
Shows the question with the specified //questionID// in the questionnaire. The function ''question()'' is mainly used with [[:en:create:filters|Filters and Conditional Questions]]. | Shows the question with the specified //questionID// in the questionnaire. The function ''question()'' is mainly used with [[:en:create:filters|Filters and Conditional Questions]]. |
| |
* //questionID//\\ The four-digit ID is composed of the ID of the section and the question (both two-digit) and must be given in quotation marks (single or double), e.g. '''XY01'''. | * //questionID// |
| * The four-digit ID is composed of the ID of the section and the question (both two-digit) and must be given in quotation marks (single or double), e.g. '''XY01'''. |
| * (array) You can also specify an array with multiple question IDs. These are then displayed as [[:en:create:combine|combined question]]], just like when using the parameter ''combine=...''. |
* //items//\\ The second parameter can optionally be used to specify which items in the question should be shown and/or in what order this occurs. The item IDs are either specified as an array (''array(2,4,6,8)'') or separated with a comma as a string ('''2,4,6,8'''). In order to describe items 1, 3, 5, 6, 7, 8, 9 and 10, number ranges can also be specified in the item list, e.g. '''1,3,5-10''' or ''array(1,3,'5-10')''. | * //items//\\ The second parameter can optionally be used to specify which items in the question should be shown and/or in what order this occurs. The item IDs are either specified as an array (''array(2,4,6,8)'') or separated with a comma as a string ('''2,4,6,8'''). In order to describe items 1, 3, 5, 6, 7, 8, 9 and 10, number ranges can also be specified in the item list, e.g. '''1,3,5-10''' or ''array(1,3,'5-10')''. |
* //options//\\ There is a large range of options available for fine-tuning. Any number of options can be specified for each ''question()'' command. Put each option in quotation marks (single or double) and separate multiple options with commas (see example below). | * //options//\\ There is a large range of options available for fine-tuning. Any number of options can be specified for each ''question()'' command. Put each option in quotation marks (single or double) and separate multiple options with commas (see example below). |
* '''gap=line'''\\ Display a line between the combined questions. The space or the line is displayed equally between all combined questions. | * '''gap=line'''\\ Display a line between the combined questions. The space or the line is displayed equally between all combined questions. |
* //options//\\ Some options are intended to dynamically overwrite the question's settings: | * //options//\\ Some options are intended to dynamically overwrite the question's settings: |
* '''filter=<specification>'''\\ Prefix for the database key in a question type "Extended Selection" or "Suggesting Text Input" (e.g. '''filter=country''' to show all database entries whose key begins with "country"). | * '''filter=<specification>'''\\ Prefix for the database key in a question type "Extended Selection" or "Suggesting Text Input" (e.g. '''filter=country''' to show all database entries whose key begins with "country"). To allow the correct encoding of a response in the suggesting text input, at least a part of the prefix mus be set in the question itself as //prefix//. The parameter in ''question()'' can then narrow down these options. |
* '''direction=<up|down>'''\\ Arrange selection options in a scale or in a horizontal selection in ascending (''up'') or descending (''down'') order. | * '''direction=<up|down>'''\\ Arrange selection options in a scale or in a horizontal selection in ascending (''up'') or descending (''down'') order. |
* '''composition=<default|extended|dense>'''\\ Customize setting for //Composition of a Question// . | * '''composition=<default|extended|dense>'''\\ Customize setting for //Composition of a Question// . |