Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mungkin ada beberapa situasi saat Anda lebih memilih pengguna berinteraksi dengan produk Anda di luar iframe. Anda dapat memuat konten lampiran di tab baru, bukan di iframe add-on Classroom, selama add-on Anda mematuhi pedoman berikut.
Perilaku yang diperlukan di tab atau jendela baru
Daftar persyaratan add-on Classroom menentukan perilaku tertentu saat membuka tab atau jendela baru. Tabel berikut memberikan klarifikasi dan saran penerapan terkait setiap persyaratan.
ID
Persyaratan
Cara bertemu
3.2
Jika tugas diluncurkan ke tab atau jendela baru dari perjalanan iframe mana pun, tugas tersebut HARUS memberikan pesan yang mudah digunakan untuk kembali ke Classroom.
Di situs eksternal, sertakan pesan, banner, toast, atau notifikasi lain yang menginstruksikan pengguna untuk kembali ke Classroom setelah menyelesaikan tugas.
5.1
Saat studentViewUri diluncurkan, add-on TIDAK BOLEH mengeluarkan pengguna dari iframe untuk menyelesaikan tugas.
Idealnya, pengguna dapat menyelesaikan semua perjalanan yang relevan dalam iframe. Membuka tab baru dapat membuat pengguna merasa bingung dan menambah kerumitan penggunaan add-on.
Pertahankan pengalaman pengguna dalam iframe untuk memberikan gesekan pengguna yang paling sedikit.
5.2
Jika aktivitas add-on keluar dari iframe, HARUS ada pratinjau tentang tugas di iframe.
Jangan membuka situs eksternal
segera saat pengguna mengklik
kartu lampiran. Sebagai gantinya,
sediakan tampilan
interstisial dasar di iframe yang menampilkan
gambar atau deskripsi tugas
yang terbuka di tab baru. Sertakan
petunjuk untuk membantu pengguna
berhasil menavigasi dan
menyelesaikan aktivitas.
[null,null,["Terakhir diperbarui pada 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. |"]]
