Stay organized with collections
Save and categorize content based on your preferences.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-12-19 UTC."],[[["Classroom add-ons should prioritize displaying content within the iframe for optimal user experience."],["Add-ons opening content in new tabs must include clear instructions for users to return to Classroom."],["If unavoidable, new tab content should be preceded by a preview within the iframe with task details and navigation instructions."],["While add-ons can open new tabs, keeping content within the iframe provides ease of access and reduces user effort."]]],[]]
