Open content in new tabs

There may be some situations in which you would prefer to provide additional content outside the iframe. You may therefore opt to load attachment content in a new tab rather than confine it to the iframe, provided your add-on meets the requirements specified on this page.

Required behaviors in new tabs or windows

The Classroom add-on requirements checklist specifies certain behaviors when opening new tabs or windows. The following table provides clarifications and implementation suggestions regarding the specific requirements.

ID Requirement How to meet
3.2 If a task is launched into a new tab or window from any of the iframe journeys, it MUST provide a user-friendly message to return to Classroom. On the external site, include a message, banner, toast, or other notification instructing the user to return to Classroom when finished with the task.
5.1 When the studentViewUri is launched, the add-on SHOULD NOT pop the user out of the iframe to complete a task. Ideally, users are able to complete all relevant journeys within the iframe. Opening new tabs can disorient users and adds to the complexity of using the add-on. Keep the user experience within the iframe to provide the least end-user friction.
5.2 If the add-on activity pops out of the iframe, there MUST be a preview about the task in the iframe. Don't open the external site immediately when the user clicks the attachment card. Instead, provide a basic interstitial view in the iframe showing an image or description of the task that opens in a new tab. Include instructions to help users successfully navigate and complete the activity.