Create a free text response question

  placeholder = "",
  rows = 1,
  columns = 40,
  required = FALSE,
  name = NULL



The prompt for the question


A string specifying the placeholder text


Number of rows spanned by the text box


Number of columns spanned by the text box


Is a response to the question required?


A convenient label for the question


A question object to be passed to trial_survey_text().


The question_text() function is designed to be called when using trial_survey_text() to construct a survey page that contains free text response items. When rendered as part of the study, the text specified by the prompt argument is shown to the participant, with a text box placed underneath into which a response may be typed. The size of the text box can be customised by specifying the number of text rows and columns. If a placeholder string is specified (e.g., placeholder = "Type your answer here") it is displayed in faded text within the box, and will disappear as soon as the participant begins typing the response.

If required = TRUE the participant will not be allowed to continue to the next trial unless an answer is provided.

The name argument should be a string that provides a convenient label for the question. If left unspecified, jsPsych defaults to labelling the questions within a survey page as "Q0", "Q1", "Q2", etc.

See also

Survey page trials are constructed using the trial_survey_text, trial_survey_likert, trial_survey_multi_choice and trial_survey_multi_select functions. Individual questions for survey trials can be specified using question_text, question_likert and question_multi.