קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יכול להיות שיהיו מצבים שבהם תעדיפו שהמשתמשים יקיימו אינטראקציה עם המוצר שלכם מחוץ ל-iframe. אתם יכולים לטעון תוכן של קבצים מצורפים בכרטיסייה חדשה במקום ב-iframe של תוסף ל-Classroom, בתנאי שהתוסף שלכם עומד בהנחיות הבאות.
התנהגויות נדרשות בכרטיסיות או בחלונות חדשים
ברשימת הדרישות לתוסף Classroom מפורטים התנהגויות מסוימות שמתרחשות כשפותחים כרטיסיות או חלונות חדשים. בטבלה הבאה מפורטים הסברים והצעות להטמעה לגבי כל דרישה.
מזהה
דרישה
איך נפגשים
3.2
אם משימה מופעלת בכרטיסייה או בחלון חדשים מתוך אחד מהמסלולים של iframe, היא חייבת לספק הודעה ידידותית למשתמש כדי לחזור אל Classroom.
באתר החיצוני, מוסיפים הודעה, באנר, טוסט או הודעה אחרת שמנחה את המשתמש לחזור ל-Classroom כשהוא מסיים את המשימה.
5.1
כשמפעילים את studentViewUri, התוסף לא אמור להוציא את המשתמש מה-iframe כדי להשלים משימה.
האידיאל הוא שהמשתמשים יוכלו להשלים את כל התהליכים הרלוונטיים בתוך ה-iframe. פתיחת כרטיסיות חדשות עלולה לבלבל את המשתמשים ולהוסיף מורכבות לשימוש בתוסף.
כדי למזער את החיכוך עם המשתמשים, חשוב לשמור על חוויית המשתמש בתוך ה-iframe.
5.2
אם הפעילות של התוסף מופיעה מחוץ ל-iframe, צריך להציג תצוגה מקדימה של המשימה ב-iframe.
לא לפתוח את האתר החיצוני באופן מיידי כשמשתמש לוחץ על כרטיס הקובץ המצורף. במקום זאת,
צריך לספק תצוגה בסיסית של מודעת מעברון
ב-iframe, עם תמונה או תיאור של המשימה
שנפתחת בכרטיסייה חדשה. צריך לכלול הוראות שיעזרו למשתמשים להתמצא בפעילות ולהשלים אותה.
[null,null,["עדכון אחרון: 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. |"]]
