Skip to main content
Version: v2.4.0

LikertResponse

Defined in: parser/types.ts:469

The LikertResponse interface is used to define the properties of a likert response. LikertResponses render as radio buttons with a user specified number of options, which can be controlled through the numItems. For example, numItems: 5 will render 5 radio buttons, and numItems: 7 will render 7 radio buttons. LikertResponses can also have a description, and left and right labels. The left and right labels are used to label the left and right ends of the likert scale with values such as 'Strongly Disagree' and 'Strongly Agree'.

Example for a five-point Likert Scale:

{
"id": "q-satisfaction",
"prompt": "Rate your satisfaction from 1 (not enjoyable) to 5 (very enjoyable).",
"location": "aboveStimulus",
"type": "likert",
"leftLabel": "Not Enjoyable",
"rightLabel": "Very Enjoyable",
"labelLocation": "inline",
"numItems": 5,
"start": 1,
"spacing": 1
}

Extends

Properties

PropertyTypeDescriptionInherited fromDefined in
excludeFromRandomization?booleanExclude response from randomization. If present, will override the responseOrder randomization setting in the components. Defaults to false.BaseResponse.excludeFromRandomizationparser/types.ts:375
hidden?booleanControls whether the response is hidden.BaseResponse.hiddenparser/types.ts:365
idstringThe id of the response. This is used to identify the response in the data file.BaseResponse.idparser/types.ts:347
infoText?stringThe description that is displayed when the participant hovers over the response. This does not accept markdown.BaseResponse.infoTextparser/types.ts:353
labelLocation?"above" | "inline" | "below"The location of the labels. Defaults to inline.-parser/types.ts:482
leftLabel?stringThe left label of the likert scale. E.g Strongly Disagree-parser/types.ts:478
location?ConfigResponseBlockLocationControls the response location. These might be the same for all responses, or differ across responses. Defaults to belowStimulusBaseResponse.locationparser/types.ts:357
numItemsnumberThe number of options to render.-parser/types.ts:472
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:363
promptstringThe prompt that is displayed to the participant. You can use markdown here to render images, links, etc.BaseResponse.promptparser/types.ts:349
required?booleanControls whether the response is required to be answered. Defaults to true.BaseResponse.requiredparser/types.ts:355
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:361
requiredValue?unknownYou can provide a required value, which makes it so a participant has to answer with that value.BaseResponse.requiredValueparser/types.ts:359
rightLabel?stringThe right label of the likert scale. E.g Strongly Agree-parser/types.ts:480
secondaryText?stringThe secondary text that is displayed to the participant under the prompt. This does not accept markdown.BaseResponse.secondaryTextparser/types.ts:351
spacing?numberThe spacing between the options. Defaults to 1.-parser/types.ts:476
start?numberThe starting value of the likert scale. Defaults to 1.-parser/types.ts:474
style?StylesYou can set styles here, using React CSSProperties, for example: {"width": 100} or {"width": "50%"}BaseResponse.styleparser/types.ts:373
stylesheetPath?stringThe path to the external stylesheet file.BaseResponse.stylesheetPathparser/types.ts:371
type"likert"--parser/types.ts:470
withDivider?booleanRenders the response with a trailing divider. If present, will override the divider setting in the components or uiConfig.BaseResponse.withDividerparser/types.ts:367
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:369