مرجع عناصر HTML : عنصر <fencedframe> (آزمایشی)

عنصر <fencedframe> یک زمینه مرور تو در تو را نشان می‌دهد که صفحه HTML دیگری را در صفحه فعلی جاسازی می‌کند.

ها از نظر شکل و عملکرد بسیار شبیه به عناصر هستند، با این تفاوت که: ارتباط بین محتوای و سایت جاسازی آن محدود شده است. یک می‌تواند به داده‌های بین سایتی دسترسی داشته باشد، اما فقط در مجموعه‌ای بسیار خاص از شرایط کنترل‌شده که حریم خصوصی کاربر را حفظ می‌کند. یک را نمی‌توان دستکاری کرد یا از طریق اسکریپت‌نویسی معمولی (مثلاً خواندن یا تنظیم URL منبع) به داده‌های آن دسترسی داشت. محتوای را فقط می‌توان از طریق APIهای خاص جاسازی کرد. یک نمی‌تواند به DOM زمینه جاسازی دسترسی داشته باشد، و زمینه جاسازی نیز نمی‌تواند به DOM دسترسی داشته باشد. عنصر نوعی است که ویژگی‌های حریم خصوصی بومی بیشتری در آن تعبیه شده است. این عنصر کاستی‌های ها مانند وابستگی به کوکی‌های شخص ثالث و سایر خطرات حریم خصوصی را برطرف می‌کند. برای جزئیات بیشتر به API فریم حصارکشی شده مراجعه کنید.

ویژگی‌ها

این عنصر شامل ویژگی‌های سراسری است. allow یک سیاست مجوز برای مشخص می‌کند که مشخص می‌کند چه ویژگی‌هایی بر اساس مبدا درخواست برای در دسترس هستند. برای جزئیات بیشتر در مورد اینکه کدام ویژگی‌ها را می‌توان از طریق یک سیاست تنظیم شده روی یک قاب حصارکشی شده کنترل کرد، به سیاست‌های مجوز موجود برای قاب‌های حصارکشی شده مراجعه کنید. height یک عدد صحیح بدون واحد که نشان دهنده ارتفاع قاب حصارکشی شده بر حسب پیکسل‌های CSS است. مقدار پیش‌فرض ۱۵۰ است. width یک عدد صحیح بدون واحد که نشان دهنده عرض قاب حصارکشی شده بر حسب پیکسل‌های CSS است. مقدار پیش‌فرض ۳۰۰ است.

سیاست‌های دسترسی موجود برای fencedframe

مجوزهایی که از متن سطح بالا به یک فریم حصارکشی شده برای اجازه دادن و رد کردن ویژگی‌ها واگذار می‌شوند، می‌توانند به عنوان یک کانال ارتباطی استفاده شوند، بنابراین یک تهدید برای حریم خصوصی محسوب می‌شوند. در نتیجه، ویژگی‌های استاندارد وب که می‌توانند از طریق سیاست مجوزها، دسترسی‌پذیری خود را کنترل کنند (به عنوان مثال، دوربین یا موقعیت مکانی) در فریم‌های حصارکشی شده در دسترس نیستند. تنها ویژگی‌هایی که می‌توانند توسط یک سیاست در داخل فریم‌های حصارکشی شده فعال شوند، ویژگی‌های خاصی هستند که برای استفاده در داخل فریم‌های حصارکشی شده طراحی شده‌اند: API مخاطب محافظت‌شده attribution-reporting private-aggregation shared-storage shared-storage-select-url API ذخیره‌سازی مشترک attribution-reporting private-aggregation shared-storage shared-storage-select-url در حال حاضر، این موارد همیشه در داخل فریم‌های حصارکشی شده فعال هستند. در آینده، اینکه کدام یک از آنها فعال شوند، با استفاده از ویژگی allow قابل کنترل خواهند بود. مسدود کردن ویژگی‌های sandbox حریم خصوصی به این روش، بارگیری فریم حصارکشی شده را نیز مسدود می‌کند - به هیچ وجه هیچ کانال ارتباطی وجود نخواهد داشت.

فوکوس کردن در fencedframe

قابلیت جابجایی فوکوس فعال سند از مرزهای قاب محصور شده (یعنی از عنصری خارج از قاب محصور شده به عنصری داخل آن یا برعکس) محدود است. اقدامات آغاز شده توسط کاربر مانند کلیک یا تب می‌توانند این کار را انجام دهند، زیرا هیچ خطری برای ردیابی اثر انگشت وجود ندارد. با این حال، تلاش برای عبور از مرز از طریق فراخوانی API مانند ممنوع است - یک اسکریپت مخرب می‌تواند از مجموعه‌ای از چنین فراخوانی‌هایی برای نشت اطلاعات استنباط شده در سراسر مرز استفاده کند.

موقعیت‌یابی و مقیاس‌بندی

عنصر به عنوان یک عنصر جایگزین، امکان تنظیم موقعیت سند جاسازی‌شده درون کادر خود را با استفاده از ویژگی object-position فراهم می‌کند. ویژگی object-fit هیچ تاثیری بر عناصر ندارد. اندازه محتوای جاسازی‌شده می‌تواند توسط ویژگی‌های داخلی contentWidth و contentHeight شیء پیکربندی تنظیم شود. در چنین مواردی، تغییر عرض یا ارتفاع اندازه محفظه جاسازی‌شده در صفحه را تغییر می‌دهد، اما سند درون محفظه به صورت بصری برای تناسب مقیاس‌بندی می‌شود. عرض و ارتفاع گزارش‌شده سند جاسازی‌شده (یعنی Window.innerWidth و Window.innerHeight) بدون تغییر باقی خواهد ماند.

دسترسی‌پذیری

افرادی که با فناوری کمکی، مانند صفحه‌خوان، پیمایش می‌کنند، می‌توانند از ویژگی عنوان در برای برچسب‌گذاری محتوای آن استفاده کنند. مقدار عنوان باید به طور خلاصه محتوای جاسازی شده را توصیف کند:

HTML

بدون این عنوان، آنها باید به بروند تا محتوای جاسازی‌شده‌ی آن را تعیین کنند. این تغییر زمینه می‌تواند گیج‌کننده و زمان‌بر باشد، به‌خصوص برای صفحاتی که چندین دارند و/یا اگر جاسازی‌ها حاوی محتوای تعاملی مانند ویدیو یا صدا باشند.

مثال

برای تنظیم اینکه چه محتوایی در نمایش داده شود، یک API (مانند Protected Audience یا Shared Storage) یک شیء FencedFrameConfig تولید می‌کند که سپس به عنوان مقدار ویژگی پیکربندی تنظیم می‌شود. مثال زیر یک FencedFrameConfig را از حراج تبلیغات API Protected Audience دریافت می‌کند که سپس برای نمایش تبلیغ برنده در استفاده می‌شود:

HTML

JAVASCRIPT

resolveToConfig: مقدار true باید به فراخوانی ارسال شود تا یک شیء FencedFrameConfig دریافت شود. اگر تنظیم نشده باشد، Promise حاصل به یک URN تبدیل می‌شود که فقط می‌تواند در یک استفاده شود.

مشخصه	توضیحات
دسته بندی محتوا	Flow content, phrasing content, embedded content, interactive content, palpable content.
محتوای مجاز	هیچ کدام.
حذف برچسب	هیچکدام، هر دو تگ شروع و پایان اجباری هستند.
والدین مجاز	هر عنصری که محتوای جاسازی‌شده را می‌پذیرد.
نقش ضمنی ARIA	بدون نقش متناظر
نقش‌های مجاز ARIA	application, document, img, none, presentation
رابط DOM	pHTMLFencedFrameElement