⏱️ Quick Start

🧰 Functionality Overview

Use the component panel to customize settings, such as:
- Setting the component up as multiple choice with a single input (the default), or multiple selection.
- Keeping items in the same order you added them, or randomizing the order
- Switching between a vertical or horizontal layout

🖼️ Images can be added while editing the text content of any item.
- Requires a URL
- Make sure you add alt text!

Authoring Tips:
- As with all text in Advanced Author, make sure you paste without formatting when editing the item text, otherwise you might paste in formatting that you don’t want!

♿ Accessibility

Feature	Status
Keyboard	✅
Screen Reader	✅
Touch	✅

🧠 Trap States & Use Cases

Note: The common CAPI include selectedChoice for a single response, and selectedChoices for multi-response. The corresponding value equals the index of the item. So

🔹 Initial States (Setup)

Scenario	CAPI
Disable selection on later subscreens	`stage.MCQ.Enabled Boolean = false`
Pre-fill with a selected option (MCQ)	`stage.MCQ.selectedChoice Number = 1`
Note: The corresponding value equals the index of the item. So the first item = 1, the second = 2, and so on.
Pre-fill with selected options (MSQ)	`stage.MSQ.selectedChoices Array = 1,2,3`
Note the difference between single input (number) and multiple input (array).

✅ Correct States

Scenario	CAPI
Check for a single correct answer	`stage.MCQ.selectedChoice Number = 3`
Check for a multiple correct answers	`stage.MSQ.selectedChoices Array = 1,4`
Check for any answer	`stage.MCQ.numberOfSelectedChoices Number = 1`

** Change input number to associated blank*

❌ Incorrect States

Scenario	CAPI
Incomplete: didn’t select anything	`stage.MCQ.numberOfSelectedChoices Number = 0`
Incomplete: didn’t select enough items	`stage.MSQ.numberOfSelectedChoices Number < 2`
Incorrect: isn’t the correct item	`stage.MCQ.selectedChoice Number != 3`
Incorrect: specific incorrect item	`stage.MCQ.selectedChoice Number = 2`
Incorrect: contains some but not all of the correct items	`stage.MSQ.selectedChoices Array Contains Any 1,4`

🔄 Mutate States

Scenario	CAPI
Disable selection on later subscreens	`stage.MCQ.Enabled Boolean = false`
Show a selected option (MCQ)	`stage.MCQ.selectedChoice Number = 1`
Note: The corresponding value equals the index of the item. So the first item = 1, the second = 2, and so on.
Show multiple selected options (MSQ)	`stage.MSQ.selectedChoices Array = 1,2,3`
Note the difference between single input (number) and multiple input (array).

🍽️ CAPI Table

CAPI Name	Type	Default	Description	Examples / Notes
enabled	boolean	true	enables/disables the component
numberOfSelectedChoices	Number		checks how many items have been selected	often used for the incomplete/blank trapstate
randomize	Boolean	false	randomizes the order of the items
selectedChoice	Number		This is often used to check which item is currently selected (single input only!)	Also used to check to see if a specific item isn’t selected. Used for correct and incorrect states.
selectedChoices	Array		This is often used to check which items are currently selected (multi-select only!)	Also used to check to see if a specific item isn’t selected. Used for correct and incorrect states.
selectedChoiceText	String		Checks to see the text content of the select item	single input only
selectedChoicesText	Array		Checks to see the text content of the select items	multi-select only