Skip to main content
Version: v2.0.0

MarkdownComponent

Defined in: parser/types.ts:576

The MarkdownComponent interface is used to define the properties of a markdown component. The components can be used to render many different things, such as consent forms, instructions, and debriefs. Additionally, you can use the markdown component to render images, videos, and other media, with supporting text. Markdown components can have responses (e.g. in a consent form), or no responses (e.g. in a help text file). Here's an example with no responses for a simple help text file:

{
"type": "markdown",
"path": "<study-name>/assets/help.md",
"response": []
}

Extends

Properties

PropertyTypeDescriptionInherited fromDefined in
allowFailedTraining?booleanControls whether the component should allow failed training. If not provided, the default is true.BaseIndividualComponent.allowFailedTrainingparser/types.ts:548
correctAnswer?Answer[]The correct answer to the component. This is used for training trials where the user is shown the correct answer after a guess.BaseIndividualComponent.correctAnswerparser/types.ts:542
description?stringThe description of the component. This is used to identify and provide additional information for the component in the admin panel.BaseIndividualComponent.descriptionparser/types.ts:552
instruction?stringThe instruction of the component. This is used to identify and provide additional information for the component in the admin panel.BaseIndividualComponent.instructionparser/types.ts:554
instructionLocation?"sidebar" | "aboveStimulus" | "belowStimulus"The location of the instructions.BaseIndividualComponent.instructionLocationparser/types.ts:540
meta?Record<string, unknown>The meta data for the component. This is used to identify and provide additional information for the component in the admin panel.BaseIndividualComponent.metaparser/types.ts:550
nextButtonDisableTime?numberA timeout (in ms) after which the next button will be disabled.BaseIndividualComponent.nextButtonDisableTimeparser/types.ts:558
nextButtonEnableTime?numberA timer (in ms) after which the next button will be enabled.BaseIndividualComponent.nextButtonEnableTimeparser/types.ts:560
nextButtonLocation?"sidebar" | "aboveStimulus" | "belowStimulus"The location of the next button.BaseIndividualComponent.nextButtonLocationparser/types.ts:538
nextButtonText?stringThe text that is displayed on the next button.BaseIndividualComponent.nextButtonTextparser/types.ts:536
pathstringThe path to the markdown file. This should be a relative path from the public folder.-parser/types.ts:579
provideFeedback?booleanControls whether the component should provide feedback to the participant, such as in a training trial. If not provided, the default is false.BaseIndividualComponent.provideFeedbackparser/types.ts:544
recordAudio?booleanWhether or not to record audio for a component. Only relevant if recordStudyAudio in the uiConfig is true. Defaults to false.BaseIndividualComponent.recordAudioparser/types.ts:556
responseResponse[]The responses to the componentBaseIndividualComponent.responseparser/types.ts:532
responseDividers?booleanWhether to show the response dividers. Defaults to false.BaseIndividualComponent.responseDividersparser/types.ts:562
trainingAttempts?numberThe number of training attempts allowed for the component. The next button will be disabled until either the correct answer is given or the number of attempts is reached. When the number of attempts is reached, if the answer is incorrect still, the correct value will be shown to the participant. The default value is 2. Providing a value of -1 will allow infinite attempts and the participant must enter the correct answer to continue, and reVISit will not show the correct answer to the user.BaseIndividualComponent.trainingAttemptsparser/types.ts:546
type"markdown"--parser/types.ts:577