Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
W niektórych sytuacjach możesz preferować, aby użytkownicy korzystali z Twojej usługi poza ramką iframe. Możesz wczytywać zawartość załącznika w nowej karcie, a nie w elemencie iframe dodatku do Classroom, o ile dodatek jest zgodny z tymi wytycznymi.
wynikające z tworzenia dodatku do Classroom.
Wymagane działania na nowych kartach lub w nowych oknach
Lista wymagań dotyczących dodatku do Classroom określa pewne zachowania podczas otwierania nowych kart lub okien. W tabeli poniżej znajdziesz wyjaśnienia i sugestie dotyczące wdrażania poszczególnych wymagań.
Identyfikator
Wymaganie
Jak się spotkać
3.2
Jeśli zadanie zostanie uruchomione w nowej karcie lub nowym oknie z dowolnej ścieżki iframe, MUSI wyświetlać przyjazny dla użytkownika komunikat, który umożliwia powrót do Classroom.
Na stronie zewnętrznej umieść wiadomość, baner, wyskakujące okienko lub inne powiadomienie z instrukcją, aby po zakończeniu zadania użytkownik wrócił do Classroom.
5.1
Gdy studentViewUri jest uruchomiony, dodatek NIE POWINIEN przenosić użytkownika z elementu iframe, aby mógł wykonać zadanie.
Najlepiej, jeśli użytkownicy mogą przejść wszystkie odpowiednie ścieżki w ramce iframe. Otwieranie nowych kart może dezorientować użytkowników i zwiększać złożoność korzystania z dodatku.
Zapewnij użytkownikom wygodę, utrzymując ich w ramce iframe.
5.2
Jeśli aktywność dodatku wyjdzie poza element iframe, w elemencie iframe MUSI być widoczny podgląd zadania.
Nie otwieraj witryny zewnętrznej od razu, gdy użytkownik kliknie kartę załącznika. Zamiast tego w ramce iframe wyświetlaj podstawową reklamę pełnoekranową z obrazem lub opisem zadania, która otwiera się w nowej karcie. Dodaj instrukcje, które pomogą użytkownikom skutecznie poruszać się po aktywności i ją ukończyć.
[null,null,["Ostatnia aktualizacja: 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. |"]]
