برچسب <iframe> در اچ‌تی‌ام‌ال

از ویکی‌کد، دانشنامهٔ برنامه‌نویسی
پرش به ناوبری پرش به جستجو
یک فریم درون خطی را تعریف می‌کند
معرفی شده در نسخهٔ:۴٫۰۱
حذف شده در نسخهٔ: هنوز در حال استفاده است
ویژگی‌های مجاز:به پائین مراجعه کنید
تنظیمات پیش‌فرض CSS:به پائین مراجعه کنید

{{منو اسکرول چپ|نام منو={{مرجع منو اچ‌تی‌ام‌ال|expanded=مرجع}}}}

مثال

یک قاب (فریم) درون‌خطی به صورت زیر نشانه‌گذاری می‌شود:


تعریف و کاربرد

برچسب <iframe> یک قاب (فریم) درون‌خطی را مشخص می‌کند.[۱]

از یک قاب درون‌خطی برای جاسازی یک سند دیگر درون سند اچ‌تی‌ام‌ال کنونی استفاده می‌شود.

پشتیبانی مرورگر

عنصر Chrome Internet Explorer / Edge Firefox Safari Opera
<iframe> بله بله بله بله بله

نکات و ملاحظات

نکته: از CSS برای سبک‌دهی به <iframe> استفاده کنید (حتی شامل نوار مرور (اسکرول‌بارها) می‌شود)

ویژگی‌ها

ویژگی مقدار شرح
allow Specifies a feature policy for the <iframe>

یک سیاست‌گذاری ویژگی را برای <iframe> مشخص می‌کند

allowfullscreen true

false

باید روی true تنظیم شود اگر <iframe> قرار است حالت تمام‌صفحه (fullscreen) را با خواندن روش requestFullscreen() فعال کند
allowpaymentrequest true

false

Set to true if a cross-origin <iframe> should be allowed to invoke the Payment Request API

اگر قرار باشد که به یک <iframe> بین-مبدائی (cross-origin) اجازه داده‌شود تا API درخواست پرداخت را فراخوانی کند، باید روی true تنظیم شود

height pixels ارتفاع <iframe> را مشخص می‌کند. ارتفاع پیش‌فرض ۱۵۰ پیکسل است.
name text نام یک <iframe> را مشخص می‌کند.
referrerpolicy no-referrer

no-referrer-when-downgrade

origin

origin-when-cross-origin

same-origin

strict-origin

strict-origin-when-cross-origin

unsafe-url

مشخص می‌کند که چقدر/کدام اطلاعات ارجاع‌دهنده قرار است هنگام پردازش ویژگی‌های iframe، فرستاده شود
sandbox allow-forms

allow-pointer-lock

allow-popups

allow-same-origin

allow-scripts

allow-top-navigation

مجموعه محدودیت‌های اضافی را برای محتوای درون <iframe> فعال می‌کند
src URL نشانی سند را برای جاسازی درون <iframe> مشخص می‌کند
srcdoc HTML_code محتوای اچ‌تی‌ام‌ال از صفحه را برای نشان دادن در <iframe> مشخص می‌کند
width pixels پهنای <iframe> را مشخص می‌کند. پهنای پیش‌فرض ۳۰۰ پیکسل است

ویژگی‌های سراسری

همچنین برچسب <iframe> از ویژگی‌های سراسری (Global Attributes) در اچ‌تی‌ام‌ال پشتیبانی می‌کند.

ویژگی‌های رویداد

همچنین برچسب <iframe> از ویژگی‌های رویداد (Event Attributes) در اچ‌تی‌ام‌ال پشتیبانی می‌کند.

مثال‌های بیشتر

مثال

لبه‌ها (borders) را به iframe اضافه کنید (با CSS):

<iframe src="/default.asp" width="100%" height="300" style="border:1px solid black;">
</iframe>

<iframe src="/default.asp" width="100%" height="300" style="border:none;">
</iframe>


صفحات مرتبط

آموزش اچ‌تی‌ام‌ال: Iframeهای اچ‌تی‌ام‌ال (HTML Iframes)

مرجع DOM اچ‌تی‌ام‌ال: شیء IFrame (IFrame Object)

تنظیمات پیش‌فرض CSS

بیشتر مرورگرها عنصر <iframe> را با مقادیر پیش‌فرض زیر نمایش می‌دهند:

iframe:focus {
  outline: none;
}

iframe[seamless] {
  display: block;
}


منابع آموزشی