] } ] }
5.4.3 Parameters
frameOptions [Array] List of frames that can be created by this randomizer. Each frame is an object with any nec-essary frame-specific properties specified. The ‘kind’ of frame can be specified either here (per frame) or in commonFrameProperties. If a property is defined for a given frame both in this frame list and in common-FrameProperties, the value in the frame list will take precedence.
(E.g., you could include ‘kind’: ‘normal-frame’ in commmonFrameProperties, but for a single frame in frameOptions, include ‘kind’: ‘special-frame’.)
commonFrameProperties [Object] Object describing common parameters to use in EVERY frame created by this randomizer. Parameter names and values are as described in the documentation for the frameType used.
whichFrames [Number or Array] Index or indices (0-indexed) within frameOptions to actually use. This can be either a number (e.g., 0 to use the first option or 1 to use the second option) or an array providing an ordered list of indices to use (e.g., [1, 0] to use the second then first options). All indices must be integers in [0, frameOptions.length).
If not provided or -1, the entire frameOptions list is used in order. (If an empty list is provided, however, that is respected and no frames are inserted by this randomizer.)
5.4.4 Data collected
The information returned by this randomizer will be available in expData["conditions"]["THIS-RANDOMIZER-ID"].
The randomizer ID will depend on its order in the study - for instance, 6-test-trials.
whichFrames [Array] the index/indices of the frame(s) used, as provided to this frame
5.5 exp-text-block
5.5.1 Overview
This is a small utility for displaying text that a variety of frames use. If the frame documentation said that some parameter would be rendered by block, or that it should be a list of blocks each to be rendered by exp-text-block, you’re in the right place to learn how to format that parameter.
5.5.2 Examples
Single block: title and text
"example-text-frame": {
"kind": "exp-lookit-text",
"blocks": [ {
"title": "Lorem ipsum",
"text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do
˓→eiusmod tempor incididunt ut labore et dolore magna aliqua. Suscipit adipiscing
˓→bibendum est ultricies integer quis auctor. Imperdiet sed euismod nisi porta lorem
˓→mollis. Sollicitudin tempor id eu nisl nunc mi. Aliquet lectus proin nibh nisl
˓→condimentum. Ac tincidunt vitae semper quis lectus nulla at volutpat. Mauris sit
˓→amet massa vitae tortor condimentum lacinia. Tincidunt vitae semper quis lectus
˓→nulla at volutpat. Elementum curabitur vitae nunc sed. Pharetra convallis posuere
˓→morbi leo."
} ] }
Single block: text and image
"example-text-frame": {
"kind": "exp-lookit-text",
"blocks": [ {
"text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do
˓→eiusmod tempor incididunt ut labore et dolore magna aliqua. Suscipit adipiscing
˓→bibendum est ultricies integer quis auctor. Imperdiet sed euismod nisi porta lorem
˓→mollis. Sollicitudin tempor id eu nisl nunc mi. Aliquet lectus proin nibh nisl
˓→condimentum. Ac tincidunt vitae semper quis lectus nulla at volutpat.",
"image": {
"src": "https://www.mit.edu/~kimscott/placeholderstimuli/img/apple.jpg
˓→",
"alt": "Red apple"
} } ] }
5.5. exp-text-block 179
Note that there may be formatting applied to the image based on the particular frame.
Single block: text and listblocks
"example-text-frame": {
"kind": "exp-lookit-text",
"blocks": [ {
"text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do
˓→eiusmod tempor incididunt ut labore et dolore magna aliqua.",
"listblocks": [ {
"text": "Suscipit adipiscing bibendum est ultricies integer quis
˓→auctor."
}, {
"text": "Imperdiet sed euismod nisi porta lorem mollis."
}, {
"text": "Sollicitudin tempor id eu nisl nunc mi."
} ] } ] }
Note that there may be formatting applied to the image based on the particular frame.
Three blocks
In many frames you can specify a list of blocks to be rendered by exp-text-block - here’s an example:
"example-text-frame": {
"kind": "exp-lookit-text",
"blocks": [ {
"title": "Lorem ipsum",
"text": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do
˓→eiusmod tempor incididunt ut labore et dolore magna aliqua.",
"listblocks": [ {
"text": "Suscipit adipiscing bibendum est ultricies integer quis
˓→auctor."
}, {
"text": "Imperdiet sed euismod nisi porta lorem mollis."
}, {
"text": "Sollicitudin tempor id eu nisl nunc mi."
} ] }, {
"title": "Nulla porttitor",
"text": " Nulla porttitor massa id neque aliquam. Ac felis donec et odio
˓→pellentesque diam. Nisl vel pretium lectus quam id leo. "
}, {
"image": {
"src": "https://www.mit.edu/~kimscott/placeholderstimuli/img/apple.jpg
˓→",
"alt": "Red apple"
},
"listblocks": [ {
"text": "Est ante in nibh mauris cursus."
}, {
"text": "Ut aliquam purus sit amet luctus venenatis lectus."
},
(continues on next page)
5.5. exp-text-block 181
(continued from previous page) {
"text": "Cras ornare arcu dui vivamus arcu felis bibendum ut."
} ] } ] }
Inserting a link
"example-text-frame": {
"kind": "exp-lookit-text",
"blocks": [ {
"title": "Lorem ipsum",
"text": "Here is a link to <a href='https://lookit.mit.edu/' target='_
˓→blank' rel='noopener'>Lookit</a>."
} ] }
5.5.3 Parameters
All of the following are optional:
title [String] Title text to display at the top of this block
text [String] Main text of this block. You can use n or <br> for paragraph breaks. You can use HTML inside the text, for instance to include a link or an image.
emph whether to show this text in bold
image [Object] Image to display along with this block. Needs two fields:
src URL of image alt alt-text for image
listblocks [Array] A list of items to display in bullet points. Each item is itself rendered with exp-text-block, so it is an object that can have title, text, image, listblocks, etc.