Les modules complémentaires Google Classroom sont désormais disponibles pour tous les développeurs. Pour en savoir plus, consultez la documentation sur les modules complémentaires.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Dans certains cas, vous préférerez peut-être que les utilisateurs interagissent avec votre produit en dehors d'un iFrame. Vous pouvez charger le contenu des pièces jointes dans un nouvel onglet plutôt que dans un iFrame de module complémentaire Classroom, à condition que votre module complémentaire respecte les consignes suivantes.
Comportements requis dans les nouveaux onglets ou fenêtres
La checklist des exigences du module complémentaire Classroom spécifie certains comportements lors de l'ouverture de nouveaux onglets ou fenêtres. Le tableau suivant fournit des précisions et des suggestions d'implémentation pour chaque exigence.
ID
Exigence
Comment se rencontrer
3.2
Si une tâche est lancée dans un nouvel onglet ou une nouvelle fenêtre à partir de l'un des parcours d'iframe, elle DOIT fournir un message convivial pour revenir à Classroom.
Sur le site externe, incluez un message, une bannière, un toast ou une autre notification indiquant à l'utilisateur de revenir à Classroom une fois la tâche terminée.
5.1
Lorsque le studentViewUri est lancé, le module complémentaire NE DOIT PAS faire sortir l'utilisateur de l'iframe pour qu'il puisse effectuer une tâche.
Idéalement, les utilisateurs peuvent effectuer tous les parcours pertinents dans l'iFrame. L'ouverture de nouveaux onglets peut désorienter les utilisateurs et complexifie l'utilisation du module complémentaire.
Maintenez l'expérience utilisateur dans l'iFrame pour minimiser les frictions.
5.2
Si l'activité du module complémentaire s'affiche en dehors de l'iFrame, un aperçu de la tâche doit être disponible dans l'iFrame.
N'ouvrez pas le site externe immédiatement lorsque l'utilisateur clique sur la fiche de pièce jointe. À la place, fournissez une vue interstitielle de base dans l'iFrame, affichant une image ou une description de la tâche qui s'ouvre dans un nouvel onglet. Incluez des instructions pour aider les utilisateurs à naviguer et à effectuer l'activité.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]
