Skip to main content
Version: v2.4.4

ShortTextResponse

Defined in: parser/types.ts:458

The ShortTextResponse interface is used to define the properties of a short text response. ShortTextResponses render as a text input that accepts any text and can optionally have a placeholder.

{
"id": "q-short-text",
"prompt": "Short text example",
"location": "aboveStimulus",
"type": "shortText",
"default": "Jane Doe",
"placeholder": "Enter your answer here"
}

Extends​

Properties​

PropertyTypeDescriptionInherited fromDefined in
default?stringThe default value of the response. Specify a string such as "Jane Doe".-parser/types.ts:463
excludeFromRandomization?booleanExclude response from randomization. If present, will override the responseOrder randomization setting in the components. Defaults to false.BaseResponse.excludeFromRandomizationparser/types.ts:412
hidden?booleanControls whether the response is hidden.BaseResponse.hiddenparser/types.ts:402
idstringThe id of the response. This is used to identify the response in the data file.BaseResponse.idparser/types.ts:384
infoText?stringThe description that is displayed when the participant hovers over the response. This does not accept markdown.BaseResponse.infoTextparser/types.ts:390
location?ConfigResponseBlockLocationControls the response location. These might be the same for all responses, or differ across responses. Defaults to belowStimulusBaseResponse.locationparser/types.ts:394
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:400
placeholder?stringThe placeholder text that is displayed in the input.-parser/types.ts:461
promptstringThe prompt that is displayed to the participant. You can use markdown here to render images, links, etc.BaseResponse.promptparser/types.ts:386
required?booleanControls whether the response is required to be answered. Defaults to true.BaseResponse.requiredparser/types.ts:392
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:398
requiredValue?unknownYou can provide a required value, which makes it so a participant has to answer with that value.BaseResponse.requiredValueparser/types.ts:396
secondaryText?stringThe secondary text that is displayed to the participant under the prompt. This does not accept markdown.BaseResponse.secondaryTextparser/types.ts:388
style?StylesYou can set styles here, using React CSSProperties, for example: {"width": 100} or {"width": "50%"}BaseResponse.styleparser/types.ts:410
stylesheetPath?stringThe path to the external stylesheet file.BaseResponse.stylesheetPathparser/types.ts:408
type"shortText"--parser/types.ts:459
withDivider?booleanRenders the response with a trailing divider. If present, will override the divider setting in the components or uiConfig.BaseResponse.withDividerparser/types.ts:404
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:406