# Form Component¶

The Form component enables Psychopy to be used as a questionnaire tool, where participants can be presented with a series of questions requiring responses. Form items, defined as questions and response pairs, are presented simultaneously onscreen with a scrollable viewing window.

## Properties¶

Namestring

Everything in a PsychoPy experiment needs a unique name. The name should contain only letters, numbers and underscores (no punctuation marks or spaces).

Startint, float

The time that the stimulus should first appear.

Stopint, float

Governs the duration for which the stimulus is presented.

ItemsList of dicts or csv / xlsx file
A list of dicts or csv file should have the following key, value pairs / column headers:
index

The item index as a number

questionText

The item question string

questionWidth

The question width between 0 : 1

type

The type of rating e.g., ‘radio’, ‘rating’, ‘slider’

responseWidth

The question width between 0 : 1

options

A sequence of tick labels for options e.g., yes, no

layout

Response object layout e.g., ‘horiz’ or ‘vert’

questionColor

The question text font color

responseColor

The response object color

Missing column headers will be replaced by default entries. The default entries are:
index

0 (increments for each item)

questionText

Default question

questionWidth

0.7

type

rating

responseWidth

0.3

options

Yes, No

layout

horiz

questionColor

white

responseColor

white

Text heightfloat

Text height of the Form elements (i.e., question and response text).

Size[X,Y]

Size of the stimulus, to be specified in ‘height’ units.

Pos[X,Y]

The position of the centre of the stimulus, to be specified in ‘height’ units.

Space or padding between Form elements (i.e., question and response text), to be specified in ‘height’ units.

API reference for Form