Skip to main content
Version: v2.0.0-rc6

NumericalResponse

Defined in: parser/types.ts:207

The NumericalResponse interface is used to define the properties of a numerical response. NumericalResponses render as a text input that only accepts numbers, and can optionally have a min and max value, or a placeholder.

Example:

{
"id": "q-numerical",
"prompt": "Numerical example",
"location": "aboveStimulus",
"type": "numerical",
"placeholder": "Enter your age, range from 0 - 120",
"max": 120,
"min": 0
}

Extends

Properties

PropertyTypeDescriptionInherited fromDefined in
hidden?booleanControls whether the response is hidden.BaseResponse.hiddenparser/types.ts:183
idstringThe id of the response. This is used to identify the response in the data file.BaseResponse.idparser/types.ts:167
location?"sidebar" | "aboveStimulus" | "belowStimulus"Controls the response location. These might be the same for all responses, or differ across responses. Defaults to belowStimulusBaseResponse.locationparser/types.ts:175
max?numberThe maximum value that is accepted in the input.-parser/types.ts:214
min?numberThe minimum value that is accepted in the input.-parser/types.ts:212
paramCapture?stringUse to capture querystring parameters in answers such as participant_name. See the examples for how this is used, but prefer uiConfig.urlParticipantIdParam if you are capturing a participant ID.BaseResponse.paramCaptureparser/types.ts:181
placeholder?stringThe placeholder text that is displayed in the input.-parser/types.ts:210
promptstringThe prompt that is displayed to the participant. You can use markdown here to render images, links, etc.BaseResponse.promptparser/types.ts:169
required?booleanControls whether the response is required to be answered. Defaults to true.BaseResponse.requiredparser/types.ts:173
requiredLabel?stringYou can provide a required label, which makes it so a participant has to answer with a response that matches label.BaseResponse.requiredLabelparser/types.ts:179
requiredValue?unknownYou can provide a required value, which makes it so a participant has to answer with that value.BaseResponse.requiredValueparser/types.ts:177
secondaryText?stringThe secondary text that is displayed to the participant under the prompt. This does not accept markdown.BaseResponse.secondaryTextparser/types.ts:171
type"numerical"--parser/types.ts:208
withDivider?booleanRenders the response with a trailing divider.BaseResponse.withDividerparser/types.ts:185
withDontKnow?booleanRenders the response with an option for "I don't know". This counts as a completed answer for the validation.BaseResponse.withDontKnowparser/types.ts:187