Creates an n-alternative forced choice page.
NAFC_page(
label,
prompt,
choices,
labels = NULL,
save_answer = TRUE,
arrange_vertically = length(choices) > 2L,
hide_response_ui = FALSE,
response_ui_id = "response_ui",
on_complete = NULL,
admin_ui = NULL,
button_style = ""
)
Label for the current page (character scalar).
Prompt to be displayed above the response choices.
Can be either a character scalar (e.g. "What is 2 + 2?")
or an object of class "shiny.tag", e.g. shiny::tags$p("What is 2 + 2?")
.
Character vector of choices for the participant. If unnamed, then these values will be used both for button IDs and for button labels. If named, then values will be used for button IDs and names will be used for button labels.
Optional vector of labels for the NAFC choices.
If not NULL
, will overwrite the names of choices
.
This vector of labels can either be a character vector
or a list of Shiny tag objects, e.g. as created by shiny::HTML()
.
Whether or not to save the answer.
Whether to arrange the response buttons vertically (the default) as opposed to horizontally.
Whether to begin with the response interface hidden
(it can be subsequently made visible through Javascript,
using the element ID as set in response_ui_id
.
See audio_NAFC_page
for an example.).
HTML ID for the response user interface.
Optional function to execute on leaving the page
(after successful validation).
The argument list should include ...
,
and any of:
state
, the participant's state object;
answer
, the participant's most recent answer;
input
, the current page's Shiny input object;
session
, the current Shiny session object;
opt
, the test's option list as created by test_options()
.
Optional UI component for the admin panel.
Button CSS style information (character scalar).