Skip to content

Experiment Block

The idea behind the ROLEG DSL is that it allows researchers to create a variety of different experiments by choosing, adjusting and combining simple ‘building blocks’ of code. Every ROLEG experiment has one experiment block at the top level (i.e. no indentation). This experiment block is simply a container for the title of the experiment and the six main structural building blocks that are defined within it. This structure of the experiment block is summarised below. The block elements are executed in the order in which they are specified and may each occur more than once.

info
Optional.
info that informs the participant on the experiment and can be used for introduction, explanation or a thank-you message.
selfpacedreading
Optional.
selfpacedreading that presents a self-paced reading task to the participant.
audioresponse
Optional.
audioresponse that presents a verbal response task.
lexicaldecision
Optional.
lexicaldecision that presents a lexical decision task to the participant.
dictation
Optional.
dictation that presents a dictation task to the participant.
questionanswer
Optional.
questionanswer that presents a question to the participant.
fullscreen
Optional, defaults to false.
Boolean that specifies whether the experiment should be run fullscreen. If set to true, the participant is first shown a dialog "The experiment will launch in fullscreen mode when you click the button below." along with the button "Launch Experiment", always in English. Upon clicking this button, the browser window enters fullscreen mode and the experiment resumes.

Warning

Be aware the participant can manually exit fullscreen mode anytime as they remain in control of the browser. Also, some browsers may close the fullscreen mode automatically when the permission dialog for audio recording in an audioresponse block is presented. To account for this possibility, you can inform your participants (e.g. through an info block) that, when having exited fullscreen mode, they can return to fullscreen mode by pressing F11 on Windows computers or Ctrl-Cmd-F on macOS, or by using their browser's menu.

font
Optional.
font that specifies the font used for the current block.

Note

An experiment should contain at least one block.

Back to top