surveypage element

The surveypage element presents a page of survey questions.

Syntax

<surveypage surveypagename>
/ backkey = ("character") or (scancode) or (signal)
/ backlabel = "label"
/ branch = [if expression then event]
/ caption = "text"
/ finishlabel = "label"
/ fontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ inputdevice = modality
/ inputmask = "bit mask"
/ itemfontstyle = ("face name", height, bold, italic, underline, strikeout, quality)
/ itemspacing = height or expression
/ navigationbuttonfontstyle = ("face name", height, bold, italic, underline, strikeout, quality, character set)
/ navigationbuttonsize = (width, height)
/ nextkey = ("character") or (scancode) or (signal)
/ nextlabel = "label"
/ numframes = integer
/ ontrialbegin = [expression; expression; expression; ...]
/ ontrialend = [expression; expression; expression; ...]
/ orientation = layout
/ posttrialpause = integer expression
/ posttrialsignal = (modality, signal)
/ pretrialpause = integer expression
/ pretrialsignal = (modality, signal)
/ questions = [questionnumber, questionnumber = questionname; questionnumber-questionnumber = selectmode(questionname, questionname,...); questionnumber, questionnumber-questionnumber = questionname]
/ recorddata = boolean
/ responsefontstyle = ("face name", height, bold, italic, underline, strikeout, quality)
/ showbackbutton = boolean
/ showpagenumbers = boolean
/ showquestionnumbers = boolean
/ stimulusframes = [framenumber = stimulusname, stimulusname, ...; framenumber = stimulusname, ...] or [framenumber = selectionmode(stimulusname, stimulusname, stimulusname, ...)]
/ stimulustimes = [time = stimulusname, stimulusname, ...; time = stimulusname, ...] or [time = selectionmode(stimulusname, stimulusname, stimulusname, ...)]
/ subcaption = "text"
/ subcaptionfontstyle = ("face name", height, bold, italic, underline, strikeout, quality)
/ timeout = integer expression
/ trialcode = "string"
/ trialduration = integer expression
/ txcolor = (red expression, green expression, blue expression)
</surveypage>

Properties

Remarks

The surveypage element is a specialized type of trial that presents one or more survey questions. A survey page may be presented as part of a sequence of pages in a survey element, or it can be presented like as a trial trials in a block element. Survey pages can present multiple choice, free text, and slider questions, as well as plain text, images, and even rapid sequences of stimuli (pictures, video, text, sound, port signals) just like regular trials.

Examples

The following surveypage displays three questions:

<surveypage mypage>
/caption = "Please answer the following items to the best of your ability"
/ questions=[1=q1; 2=q2; 3=q3]
</surveypage>

The following surveypage displays three questions, no back button, a custom label on the next button. At the end of the page, it sets a custom value based on the response to the first question.

<surveypage mypage>
/caption = "Please answer the following items to the best of your ability"
/ questions=[1=q1; 2=q2; 3=q3]
/ showbackbutton=false
/ nextlabel="Forward"
/ ontrialend = [if (radiobuttons.q1.response == 1) values.sex = "female"]
</surveypage>