Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Potrebbero esserci alcune situazioni in cui preferisci che gli utenti interagiscano con il tuo
prodotto al di fuori di un iframe. Puoi caricare i contenuti degli allegati in una nuova scheda
anziché in un iframe del componente aggiuntivo Classroom, a condizione che il tuo
componente aggiuntivo sia conforme alle seguenti linee guida.
Comportamenti richiesti nelle nuove schede o finestre
L'elenco di requisiti del componente aggiuntivo Classroom specifica determinati
comportamenti quando si aprono nuove schede o finestre. La tabella seguente fornisce
chiarimenti e suggerimenti per l'implementazione di ciascun requisito.
ID
Requisito
Come incontrarsi
3.2
Se un'attività viene avviata in una nuova scheda o finestra da uno qualsiasi dei percorsi iframe, DEVE fornire un messaggio intuitivo per tornare a Classroom.
Sul sito esterno, includi un
messaggio, un banner, un toast o un'altra
notifica che invita l'utente
a tornare su
Classroom al termine
dell'attività.
5.1
Quando viene avviato studentViewUri, il componente aggiuntivo NON deve estrarre l'utente dall'iframe per completare un'attività.
Idealmente, gli utenti sono in grado di
completare tutti i percorsi pertinenti
all'interno dell'iframe. L'apertura di nuove
schede può disorientare gli utenti e
aumenta la complessità dell'utilizzo
del
componente aggiuntivo.
Mantieni l'esperienza utente all'interno
dell'iframe per ridurre al minimo
l'attrito per l'utente.
5.2
Se l'attività del componente aggiuntivo esce dall'iframe, deve essere presente un'anteprima dell'attività nell'iframe.
Non aprire il sito esterno
immediatamente quando l'utente fa clic
sulla scheda dell'allegato. Fornisci invece una visualizzazione
interstiziale di base
nell'iframe che mostra un'immagine
o una descrizione dell'attività
che si apre in una nuova scheda. Includi
istruzioni per aiutare gli utenti
a navigare e
completare l'attività.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[],[],null,["# Open content in new tabs\n\nThere may be some situations in which you would prefer users interact with your\nproduct outside of an iframe. You can load attachment content in a new tab\nrather than in a Classroom add-on iframe as long as your\nadd-on conforms to the following guidelines.\n| **Important:** You should adapt your content to work within the iframes if possible. Ease of access and reduced time and effort to reach content are two key benefits of building a Classroom add-on.\n\nRequired behaviors in new tabs or windows\n-----------------------------------------\n\nThe Classroom add-on [requirements checklist](/workspace/classroom/add-ons/requirements) specifies certain\nbehaviors when opening new tabs or windows. The following table provides\nclarifications and implementation suggestions regarding each requirement.\n\n| ID | Requirement | How to meet |\n|-----|-------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 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. |\n| 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 user friction. |\n| 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. |"]]