Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Em algumas situações, talvez você prefira que os usuários interajam com seu produto fora de um iframe. Você pode carregar o conteúdo do anexo em uma nova guia em vez de um iframe do complemento do Google Sala de Aula, desde que o complemento esteja de acordo com as seguintes diretrizes.
Comportamentos obrigatórios em novas guias ou janelas
A lista de requisitos do complemento do Google Sala de Aula especifica determinados
comportamentos ao abrir novas guias ou janelas. A tabela a seguir oferece esclarecimentos e sugestões de implementação sobre cada requisito.
ID
Requisito
Como se encontrar
3.2
Se uma tarefa for iniciada em uma nova
guia ou janela de qualquer um dos
fluxos de iframe, ela DEVE fornecer
uma mensagem fácil de usar para
voltar ao
Classroom.
No site externo, inclua uma mensagem, um banner, um aviso ou outra notificação instruindo o usuário a voltar para o Google Sala de Aula quando terminar a tarefa.
5.1
Quando o studentViewUri é
iniciado, o
complemento
NÃO DEVE tirar o usuário do
iframe para concluir uma tarefa.
O ideal é que os usuários consigam concluir todas as jornadas relevantes no iframe. Abrir novas
guias pode desorientar os usuários e
aumenta a complexidade de usar
o
complemento.
Mantenha a experiência do usuário dentro
do iframe para reduzir ao máximo
o atrito do usuário.
5.2
Se a atividade do complemento sair do iframe, uma prévia da tarefa precisa aparecer no iframe.
Não abra o site externo
imediatamente quando o usuário clicar
no card de anexo. Em vez disso, forneça uma visualização intersticial básica no iframe mostrando uma imagem ou descrição da tarefa que é aberta em uma nova guia. Inclua instruções para ajudar os usuários a navegar e concluir a atividade.
[null,null,["Última atualização 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. |"]]