iframe functionality and customization improvements

[ianchandlercampbell]

As noticed in Project GARDEN studies and #367 some families will accidentally click the big green "Next" button without seeing the warning text when filling out Qualtrics surveys or completing other tasks in an iframe.

This issue is comprised of three related suites of changes to the iframe frame. This issue will close the other following issues:

• 367

• 374

1. Change the optionalText parameter to display the experimenter text above the iframe

Putting the warning text/instructions text at the top will be more readily visible on different screens as well as ensure the participant can see this text before seeing the "Proceed/Next" button at the bottom of the frame.

• [x] Optional Text renamed to "instructionText
• [x] Instruction Text placed above the iframe
• [ ] (if possible) Formatting options like bold or italics made available and included in iframe documentation

2. Make the NEXT button text user-editable

Keep the default green color but allow the researcher to specify what the button says.

• [x] Determine if there are any practical limitations to implement (e.g., character limits)
• [x] Keep the "Next" text as default but give users the option to edit "nextButtonText" as mentioned in some other frame documentation
• [x] Do not allow the user to change the next button color at this time

3. Change NEXT button behavior to provide the user with more clarity on using it.

Make it so the NEXT button does not automatically proceed when first clicked. Upon first click, display default warning message before activating the button in 2 (?) seconds. Have a default for this warning text but allow it to be researcher-editable.

• [x] Disable NEXT button functionality upon first click
• [x] Display default warning text below the iframe, to the left of the NEXT button.
• [x] Allow researcher to edit a WarningMessageText parameter to change the default text
• [x] Have NEXT button enable for 2nd click after 2 (?) seconds (test different durations) to allow participant to proceed.

Default warning text:

"Please confirm that you have finished the task above! When you have finished, click the button to continue."

[ianchandlercampbell]

Hey everyone! Please feel free to edit this issue as needed-- I'm sure there are things that can be better specified.