با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
ممکن است شرایطی وجود داشته باشد که ترجیح دهید کاربران خارج از iframe با محصول شما تعامل داشته باشند. تا زمانی که برافزای شما مطابق با دستورالعملهای زیر باشد، میتوانید محتوای پیوست را در یک برگه جدید به جای iframe افزودنی Classroom بارگیری کنید.
رفتارهای مورد نیاز در برگه ها یا پنجره های جدید
چک لیست الزامات افزونه Classroom رفتارهای خاصی را هنگام باز کردن برگه ها یا پنجره های جدید مشخص می کند. در جدول زیر توضیحات و پیشنهادات اجرایی در رابطه با هر نیاز ارائه شده است.
شناسه
مورد نیاز
نحوه ملاقات
3.2
اگر یک کار در یک برگه یا پنجره جدید از هر یک از سفرهای iframe راه اندازی شود، باید یک پیام کاربرپسند برای بازگشت به Classroom ارائه دهد.
در سایت خارجی، پیام، بنر، نان تست یا اعلان دیگری را اضافه کنید که به کاربر دستور میدهد پس از اتمام کار به Classroom برگردد.
5.1
وقتی studentViewUri راهاندازی میشود، افزونه نباید کاربر را از iframe برای تکمیل یک کار بیرون بکشد.
در حالت ایده آل، کاربران می توانند تمام سفرهای مربوطه را در iframe تکمیل کنند. باز کردن برگه های جدید می تواند کاربران را منحرف کند و به پیچیدگی استفاده از افزونه می افزاید. تجربه کاربری را در iframe نگه دارید تا کمترین اصطکاک کاربر را ایجاد کنید.
5.2
اگر فعالیت افزونه از iframe خارج شود، باید یک پیش نمایش در مورد کار در iframe وجود داشته باشد.
هنگامی که کاربر روی کارت پیوست کلیک می کند، بلافاصله سایت خارجی را باز نکنید. در عوض، یک نمای بینابینی اولیه در iframe ارائه دهید که تصویر یا شرحی از کار را که در یک برگه جدید باز میشود، نشان میدهد. دستورالعمل هایی را برای کمک به کاربران در جهت یابی و تکمیل فعالیت با موفقیت درج کنید.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],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. |"]]