Skip to main content
Version: v1.0.5

RadioResponse

The RadioResponse interface is used to define the properties of a radio response. Radios have only one allowable selection. RadioResponses render as a radio input with user specified options, and optionally left and right labels.

Example:

{
"id": "q-radio",
"prompt": "Radio button example",
"required": true,
"location": "aboveStimulus",
"type": "radio",
"options": ["Option 1", "Option 2"]
}

Extends

Properties

PropertyTypeDescriptionInherited from
hidden?booleanControls whether the response is hidden.BaseResponse.hidden
idstringThe id of the response. This is used to identify the response in the data file.BaseResponse.id
leftLabel?stringThe left label of the radio group. Used in Likert scales for example-
location?"sidebar" | "aboveStimulus" | "belowStimulus"Controls the response location. These might be the same for all responses, or differ across responses. Defaults to belowStimulusBaseResponse.location
options(string | StringOption)[]The options that are displayed as checkboxes, provided as an array of objects, with label and value fields.-
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.paramCapture
promptstringThe prompt that is displayed to the participant. You can use markdown here to render images, links, etc.BaseResponse.prompt
requiredbooleanControls whether the response is required to be answered.BaseResponse.required
requiredLabel?stringYou can provide a required label, which makes it so a participant has to answer with a response that matches label.BaseResponse.requiredLabel
requiredValue?unknownYou can provide a required value, which makes it so a participant has to answer with that value.BaseResponse.requiredValue
rightLabel?stringThe right label of the radio group. Used in Likert scales for example-
secondaryText?stringThe secondary text that is displayed to the participant under the prompt. This does not accept markdown.BaseResponse.secondaryText
type"radio"--