API Docs for: 0.5.1
Show:

ExpLookitPreviewExplanation Class

A frame that to explain any blinding procedures to parents, and offer them the option to preview stimuli before the study. Two buttons allow the user to move forward: one goes to the next frame (if the parent wants to preview stimuli), and one skips the next frame and goes to the one after that (if the parent declins). Therefore, this frame should be followed by an ExpVideoPreview frame.

"frames": {
   "my-video-preview-explanation": {
       "introBlock": {
           "text": "During the videos, we'll ask that you hold your child over your shoulder like this, so that you're facing face away from the screen."
       },
       "image": {
           "alt": "Father holding child looking over his shoulder",
           "src": "https://s3.amazonaws.com/lookitcontents/exp-physics/OverShoulder.jpg"
       },
       "kind": "exp-lookit-preview-explanation",
       "skipButtonText": "Skip preview",
       "previewButtonText": "I'd like to preview the videos",
       "id": "video-preview-explanation",
       "blocks": [
           {
               "text": "The reason we ask this is that your child is learning from you all the time. Even if he or she can't see where you're looking, you may unconsciously shift towards one side or the other and influence your child's attention. We want to make sure we're measuring your child's preferences, not yours!"
           },
           {
               "text": "If you'd like to see the videos your child will be shown, you can take a look ahead of time now. It's important that you preview the videos without your child, so that the videos will still be new to them."
           }
       ],
       "showPreviousButton": true
   }
}

Methods

serializeContent

(
  • eventTimings
)
Object

The base class does not define any data to save to the server. It does, however, capture some basic event timing data. (such as when the user clicks the "next" button)

This section slightly breaks YUIDoc conventions- rather than being a literal guide to using the code, the "parameters" here are abstract descriptions of what data is captured.

Each frame that extends ExpFrameBase will send an array eventTimings back to the server upon completion. This array is an ordered list (oldest to newest) of every EVENT that happened during the frame. Each event is represented as an object with at least the properties {'eventType': EVENTNAME, 'timestamp': TIMESTAMP}. Frame-specific events may define additional properties that are sent.

Parameters:

Returns:

Properties

blocks

Object

Array of text blocks (paragraphs) to display after the image.

Sub-properties:

  • title String

    title to display

  • text String

    paragraph of text

  • emph Boolean

    whether to bold this paragraph

id

String

A unique identifier for this item

image

Object

Image to display after the intro block. (Displayed centered, with border, max height 220px.) E.g., a picture of a parent holding a child looking over their shoulder.

Sub-properties:

introBlock

Object

Object specifying first block of text (pre-image) to display.

Sub-properties:

  • title String

    title to display

  • text String

    paragraph of text

  • emph Boolean

    whether to bold this paragraph

previewButtonText

String

Text to display on the button to go to the next frame

Default: 'I\'d like to preview the videos'

showPreviousButton

Boolean

Whether to show a 'previous' button

Default: true

skipButtonText

String

Text to display on the button to skip the next frame

Default: 'Skip preview'

Events

nextFrame

Move to next frame