بازگشت به بلاگ
کد EmbediFrame

iframe چیست و کد Embed چه کاربردی دارد؟

دوریفای۱۲ دقیقه زمان برای مطالعه
iframe چیست و کد Embed چه کاربردی دارد؟
iframe چیست و کد Embed چه کاربردی دارد؟

iframe چیست و کد Embed چه کاربردی دارد؟

اگر بخواهید ویدئو، نقشه، فرم یا بخشی از یک سرویس دیگر را داخل صفحهٔ خود نشان دهید، معمولاً با یک کد Embed روبه‌رو می‌شوید. در HTML، رایج‌ترین ظرف برای این کار تگ iframe است؛ تگی که یک سند وب را در یک قاب مستقل داخل صفحه باز می‌کند. پس iframe نام یک عنصر HTML است و Embed Code نام کلی قطعه‌کدی است که یک سرویس برای جاسازی محتوای خود می‌دهد. هر کد Embed الزاماً iframe نیست و ممکن است script، object یا چند خط HTML باشد.

در این راهنما می‌بینید iframe چگونه کار می‌کند، هر attribute چه نقشی دارد، چطور ویدئوی YouTube یا آپارات و نقشهٔ گوگل را به‌صورت واکنش‌گرا قرار دهید و چگونه ریسک‌های امنیتی، افت سرعت، مشکلات دسترس‌پذیری و اثر آن بر سئو را کنترل کنید.

تگ iframe چیست و چگونه کار می‌کند؟

iframe مخفف Inline Frame است. مرورگر با دیدن این تگ، یک browsing context یا محیط مرور مستقل درون صفحه می‌سازد و نشانی قرارگرفته در src را در آن بارگذاری می‌کند. صفحهٔ اصلی و محتوای قاب دو سند جدا هستند، حتی اگر از نظر ظاهری کنار هم دیده شوند.

یک نمونهٔ پایه چنین است:

<iframe
  src="https://example.com/widget"
  title="تقویم رویدادهای آموزشی"
  width="100%"
  height="480"
  loading="lazy"
  referrerpolicy="strict-origin-when-cross-origin">
</iframe>

src منبع را مشخص می‌کند و title باید توضیحی باشد که کاربرِ screen reader بفهمد داخل قاب چه چیزی قرار دارد. width و height اندازهٔ اولیه را تعیین می‌کنند. مقدار 100% برای عرض، قاب را با والد خود هماهنگ می‌کند؛ ارتفاع ثابت هنوز ممکن است در موبایل مناسب نباشد که در بخش responsive اصلاحش می‌کنیم. loading="lazy" بارگذاری قاب‌های خارج از محدودهٔ دید را تا زمان نزدیک‌شدن کاربر عقب می‌اندازد.

برای منبع‌های خارجی از URL کامل HTTPS استفاده کنید. بارگذاری محتوای HTTP داخل صفحهٔ HTTPS، mixed content ایجاد می‌کند و مرورگر ممکن است آن را مسدود کند. همچنین بهتر است iframe را داخل یک عنصر مستقل بگذارید تا عنوان، توضیح و فاصلهٔ آن برای کاربر روشن باشد.

کد Embed چیست؟ تفاوت Embed Code با تگ embed

Embed یعنی «جاسازی». وقتی YouTube، آپارات، Google Maps یا یک سرویس فرم به شما کدی می‌دهد تا آن را در سایت قرار دهید، آن قطعه Embed Code نام دارد. سرویس تولیدکننده معمولاً src، شناسهٔ محتوا و permissionهای موردنیاز را از قبل در کد می‌گذارد.

<embed> نیز یک عنصر واقعی HTML است، اما با مفهوم عمومی Embed Code یکی نیست. این عنصر بیشتر برای قراردادن منبعی مانند فایل چندرسانه‌ای یا محتوایی استفاده می‌شود که مرورگر یا افزونه بتواند نمایش دهد. در مقابل، iframe یک سند HTML کامل را در قاب جدا باز می‌کند. object روش قدیمی‌تر و عمومی‌تری برای منابع خارجی است و script کد اجرایی سرویس را در صفحهٔ شما وارد می‌کند.

پس هنگام انتخاب، به کدی که سرویس رسمی می‌دهد وفادار بمانید. تبدیل دلخواه آن به <embed> ممکن است پشتیبانی، امنیت یا کنترل‌های ویدئو را خراب کند. برای ویدئوی معمولی نیز اگر فایل روی سرور خودتان است، عنصر بومی <video> اغلب کنترل و دسترس‌پذیری بهتری دارد.

attributeهای مهم iframe را بشناسید

چند attribute در بیشتر پروژه‌ها کاربرد دارند:

  • src: URL سند یا محتوای جاسازی‌شده.
  • title: نام توصیفی برای دسترس‌پذیری؛ عنوان‌هایی مثل «iframe» یا «صفحهٔ خارجی» اطلاعات کافی نمی‌دهند.
  • allow: قابلیت‌هایی مانند autoplay، fullscreen، camera یا microphone را محدود به موارد لازم می‌کند. مجوز اضافی ندهید.
  • sandbox: برای قاب، محدودیت‌های امنیتی می‌گذارد. مقدار خالی تقریباً همهٔ قابلیت‌های بالقوهٔ خطرناک مانند اجرای script، ارسال فرم و بازکردن پنجره را محدود می‌کند.
  • loading: با مقدار lazy، بارگذاری را برای قاب‌های پایین صفحه عقب می‌اندازد. برای محتوای حیاتی بالای صفحه از آن با احتیاط استفاده کنید.
  • referrerpolicy: مقدار ارسالی در هدر Referer را کنترل می‌کند. strict-origin-when-cross-origin انتخاب متعادلی برای بسیاری از سایت‌هاست.
  • allowfullscreen: در پروژه‌های قدیمی رایج است؛ می‌توانید allow="fullscreen" را نیز برای اعلام نیاز قاب نگه دارید.

نمونه‌ای که permission و sandbox را با هم نشان می‌دهد:

<iframe
  src="https://trusted.example/checkout"
  title="فرم پرداخت دوره"
  loading="lazy"
  sandbox="allow-forms allow-scripts allow-same-origin"
  allow="payment"
  referrerpolicy="strict-origin-when-cross-origin">
</iframe>

این مقدار sandbox فقط یک الگوی نمونه است. allow-scripts و allow-same-origin را هم‌زمان برای محتوایی که واقعاً هم‌مبدأ صفحهٔ شماست، بدون بررسی دقیق استفاده نکنید؛ ترکیب آن‌ها می‌تواند بخشی از محدودیت sandbox را کم‌اثر کند. برای هر سرویس، کمترین مجوزی را انتخاب کنید که کارکرد لازم را تأمین کند.

جاسازی ویدئو، نقشه و فرم

YouTube

در YouTube روی Share و سپس Embed بزنید و کد رسمی را بردارید. نسخهٔ زیر از دامنهٔ privacy-enhanced استفاده می‌کند و نمایش تمام‌صفحه را فقط به‌عنوان قابلیت موردنیاز اعلام می‌کند:

<iframe
  src="https://www.youtube-nocookie.com/embed/VIDEO_ID"
  title="آموزش ساخت صفحهٔ فروش دوره"
  loading="lazy"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
  allowfullscreen>
</iframe>

VIDEO_ID را با شناسهٔ واقعی ویدئو جایگزین کنید. اگر ویدئو برای پاسخ اصلی صفحه ضروری است، lazy loading را با یک پوستر و بارگذاری پس از کلیک ترکیب کنید تا کاربر بلافاصله با قاب خالی روبه‌رو نشود.

آپارات

آپارات برای هر ویدئو کد Embed مخصوص خود را ارائه می‌کند. قالب کلی زیر به شما نشان می‌دهد شناسه را در کجا قرار دهید:

<iframe
  src="https://www.aparat.com/video/video/embed/videohash/VIDEO_HASH/vt/frame"
  title="ویدئوی معرفی دورهٔ آنلاین"
  allow="fullscreen"
  loading="lazy">
</iframe>

به‌جای VIDEO_HASH مقدار موجود در کد رسمی همان ویدئو را بگذارید. آدرس‌های Embed سرویس‌ها ممکن است تغییر کنند، بنابراین کد را از صفحهٔ رسمی ویدئو کپی کنید و فقط اندازه یا CSS آن را ویرایش کنید.

Google Maps و فرم‌ها

در Google Maps، گزینهٔ Share و سپس Embed a map، یک iframe آماده می‌سازد. برای فرم ثبت‌نام یا رزرو نیز اگر ارائه‌دهنده کد رسمی دارد، همان کد را در یک wrapper واکنش‌گرا قرار دهید. محتوای فرم باید عنوان روشن و روش جایگزین داشته باشد؛ مثلاً لینکی به صفحهٔ مستقیم فرم برای کاربری که قاب را نمی‌بیند.

در WordPress، بلوک Custom HTML یا بلوک اختصاصی سرویس، جای مناسب واردکردن کد است. بعضی افزونه‌های امنیتی یا ویرایشگرهای دیداری، iframe را هنگام ذخیره حذف می‌کنند. در این حالت از Embed block رسمی همان سرویس استفاده کنید و دسترسی کاربر را بی‌دلیل افزایش ندهید.

iframe ریسپانسیو و سریع

تعیین width="560" و height="315" برای دسکتاپ در صفحهٔ باریک موبایل باعث بیرون‌زدگی یا اسکرول افقی می‌شود. روش ساده، نسبت تصویر را در wrapper نگه می‌دارد:

<div class="embed-frame">
  <iframe
    src="https://www.youtube-nocookie.com/embed/VIDEO_ID"
    title="ویدئوی معرفی محصول"
    loading="lazy"
    allow="autoplay; encrypted-media; picture-in-picture"
    allowfullscreen>
  </iframe>
</div>
.embed-frame {
  width: 100%;
  aspect-ratio: 16 / 9;
  overflow: hidden;
  border-radius: 0.75rem;
}

.embed-frame iframe {
  display: block;
  width: 100%;
  height: 100%;
  border: 0;
}

برای نقشه یا قاب‌های بلند، نسبت را مثلاً 4 / 3 کنید. aspect-ratio از رزروشدن فضا پیش از رسیدن پاسخ iframe پشتیبانی می‌کند و احتمال جابه‌جایی ناگهانی محتوا را کم می‌کند.

هر iframe یک سند و معمولاً چند منبع دیگر بار می‌کند. چند ویدئو، نقشه و چت هم‌زمان می‌توانند تعداد درخواست‌ها، مصرف حافظه و زمان تعامل را بالا ببرند. این کارها کمک می‌کنند:

  • فقط قاب‌های خارج از viewport را lazy-load کنید.
  • برای ویدئوهای متعدد، تصویر پوستر و دکمهٔ «بارگذاری ویدئو» نشان دهید و بعد از کلیک iframe را بسازید.
  • در بالای صفحه تعداد Embedها را کم نگه دارید و از سرویس‌های معتبر با خروجی سبک استفاده کنید.
  • فضا را با aspect-ratio رزرو کنید و عملکرد موبایل را با Lighthouse یا ابزار مشابه اندازه بگیرید.

امنیت iframe و جلوگیری از سوءاستفاده

محتوای ثالث را فقط از دامنه‌ای بارگیری کنید که مالک آن را می‌شناسید. قرار دادن URL قابل‌تغییرِ کاربر در src می‌تواند مسیر حمله یا نشت داده بسازد. فهرست دامنه‌های مجاز را در کد و سیاست امنیتی محدود کنید.

sandbox سطح دسترسی سند داخل قاب را کم می‌کند، اما جایگزین اعتماد به منبع نیست. allow نیز permissionهای حساس مانند دوربین، میکروفون، پرداخت و autoplay را فقط در صورت نیاز فعال می‌کند. برای محتوای حساس، رضایت کاربر و توضیح کوتاه دربارهٔ دادهٔ ارسال‌شده را در نظر بگیرید.

اگر می‌خواهید صفحهٔ خودتان داخل سایت‌های دیگر نمایش داده نشود، کنترل از سمت سرور انجام می‌شود. نمونهٔ سیاست CSP:

Content-Security-Policy: frame-ancestors 'self' https://trusted.example

frame-ancestors مشخص می‌کند چه originهایی اجازهٔ قاب‌کردن صفحه را دارند. X-Frame-Options: SAMEORIGIN نیز برای سناریوهای سادهٔ قدیمی‌تر به‌کار می‌رود، اما CSP کنترل دقیق‌تری می‌دهد. این تنظیمات با frame-src فرق دارند: frame-src تعیین می‌کند صفحهٔ شما چه iframeهایی را می‌تواند بار کند و frame-ancestors تعیین می‌کند چه سایت‌هایی می‌توانند صفحهٔ شما را قاب کنند.

این محدودیت‌ها به مقابله با clickjacking کمک می‌کنند. اگر محتوای شخص ثالث با CSP یا X-Frame-Options خودش Embed را ممنوع کرده باشد، شما نمی‌توانید از سمت مرورگر این تصمیم را دور بزنید.

iframe و سئو: چه چیزی واقعاً مهم است؟

iframe به‌خودی‌خود امتیاز مثبت یا منفی ثابت برای رتبه‌بندی ندارد. محتوای اصلی صفحهٔ خودتان را داخل iframe پنهان نکنید و انتظار نداشته باشید متن یا خدمات سایت دیگر جای توضیح منحصربه‌فرد شما را بگیرد. عنوان صفحه، متن زمینه‌ای، پاسخ سؤال کاربر و لینک‌های قابل‌خزش باید در سند اصلی وجود داشته باشند.

Google می‌تواند در برخی شرایط ویدئوی ارجاع‌شده با iframe را تشخیص دهد، اما دیده‌شدن آن به داده‌ها و ساختار صفحه وابسته است. برای صفحهٔ ویدئو، یک عنوان دقیق، توضیح واقعی، تصویر بندانگشتی باکیفیت و در صورت نیاز دادهٔ ساختاری VideoObject فراهم کنید. embedUrl را فقط وقتی درج کنید که URL واقعی پخش Embed را می‌دانید. برای صفحه‌های متعدد ویدئویی، نقشهٔ ویدئو نیز ممکن است کمک کند.

از متن تکراری تولیدکنندهٔ ویدئو، عنوان‌های عمومی و iframeهای زیاد بدون ارزش مستقل پرهیز کنید. اگر نقشه فقط برای نشان‌دادن آدرس است، آدرس و اطلاعات تماس را به‌صورت متن HTML هم بنویسید. این کار هم برای موتور جست‌وجو و هم برای کاربری که نقشه را بارگذاری نمی‌کند مفید است.

تفاوت iframe، embed، object و script

روشکاربرد اصلیکنترل و ملاحظه
iframeنمایش یک سند یا سرویس وب مستقلجداسازی مناسب، همراه با هزینهٔ بارگذاری و نیاز به title و policy
embedقراردادن منبع رسانه‌ای یا منبع قابل‌نمایشپشتیبانی وابسته به نوع منبع و کنترل محدودتر برای سند HTML
objectروش عمومی‌تر برای منابع خارجی و سازگاری قدیمیپیچیده‌تر و در بسیاری از سناریوهای وب مدرن انتخاب اول نیست
scriptافزودن قابلیت تعاملی سرویس در صفحهٔ اصلیدسترسی بیشتر به DOM و ریسک بالاتر؛ فقط از منبع قابل‌اعتماد استفاده شود
videoپخش فایل ویدئویی متعلق به خودتانکنترل بومی بهتر، امکان زیرنویس و مدیریت مستقیم فایل

اگر سرویس کد رسمی iframe می‌دهد، معمولاً همان مسیر کم‌ریسک‌تر برای محتوای سندمحور است. برای فایل خودتان ابتدا video یا HTML بومی را بررسی کنید؛ برای widget تعاملی که باید با صفحه ارتباط مستقیم داشته باشد، script می‌تواند لازم باشد.

چرا iframe نمایش داده نمی‌شود؟

این خطاها را به‌ترتیب بررسی کنید:

  1. URL را در تب جدا باز کنید و مطمئن شوید شناسه و مسیر Embed درست است.
  2. در DevTools بخش Console و Network را بخوانید. پیام‌های refused to connect معمولاً به X-Frame-Options، CSP یا ممنوعیت Embed از طرف مالک منبع مربوط‌اند.
  3. اگر صفحهٔ شما HTTPS است، URL قاب را هم HTTPS کنید تا mixed content رخ ندهد.
  4. وجود sandbox را بررسی کنید؛ شاید مجوز لازم مانند script یا فرم حذف شده باشد.
  5. در موبایل، کوکی‌های ثالث، محدودیت‌های حریم خصوصی یا مسدودکننده‌های محتوا را در نظر بگیرید.
  6. اگر قاب خالی است، برای آن ارتفاع تعیین کنید. iframe بدون ارتفاع مؤثر ممکن است عملاً دیده نشود.
  7. در WordPress بررسی کنید ویرایشگر یا افزونهٔ امنیتی کد را پاک نکرده باشد.

اگر منبع از قاب‌شدن جلوگیری کند، راه درست ارائهٔ لینک مستقیم یا استفاده از API رسمی است. تغییر هدرهای سایت دیگر از سمت شما ممکن نیست.

چه زمانی از iframe استفاده نکنیم؟

برای متن اصلی، navigation، فرم‌های ساده یا ویدئویی که مالک آن هستید، HTML بومی معمولاً کنترل بیشتری روی سئو، سرعت و دسترس‌پذیری می‌دهد. iframe زمانی منطقی است که سرویس خارجی باید رابط یا سند خودش را حفظ کند، مانند پخش‌کنندهٔ ویدئو، نقشه، پرداخت یا ابزار تخصصی.

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

پرسش‌های متداول

آیا iframe همان Embed Code است؟

خیر. iframe یک تگ HTML مشخص برای بازکردن سندی در قاب داخلی است. Embed Code عنوان کلی قطعه‌کدی است که سرویس برای جاسازی می‌دهد و می‌تواند iframe، script، object یا ترکیبی از HTML و JavaScript باشد.

آیا iframe به سئو آسیب می‌زند؟

خود iframe عامل قطعی افت رتبه نیست. مشکل زمانی ایجاد می‌شود که محتوای مهم صفحه فقط داخل قاب باشد، متن زمینه‌ای نداشته باشید، سرعت با Embedهای زیاد افت کند یا ویدئو بدون داده و ساختار مناسب ارائه شود. اطلاعات اصلی را در HTML صفحه نگه دارید.

برای ویدئو YouTube از iframe استفاده کنم یا video؟

اگر ویدئو روی YouTube میزبانی می‌شود، iframe رسمی انتخاب طبیعی است. اگر فایل ویدئو و زیرساخت آن متعلق به شماست، عنصر video کنترل مستقیم‌تری روی فایل، زیرنویس، پوستر و تجربهٔ کاربر می‌دهد.

sandbox چه کاری انجام می‌دهد؟

sandbox قابلیت‌های سند داخل iframe را محدود می‌کند؛ از جمله اجرای script، ارسال فرم یا بازکردن پنجره، مگر اینکه permission لازم را صریحاً اضافه کنید. مقدار مناسب به نیاز سرویس وابسته است و باید با کمترین دسترسی آزمایش شود.

چرا بعضی سایت‌ها داخل iframe باز نمی‌شوند؟

صاحب سایت ممکن است با Content-Security-Policy: frame-ancestors یا X-Frame-Options قاب‌شدن را ممنوع کرده باشد. URL اشتباه، mixed content، کوکی‌های ثالث و sandbox بیش‌ازحد محدودکننده نیز علت‌های رایج‌اند.

آیا loading="lazy" را برای همهٔ iframeها بگذارم؟

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

چگونه iframe را در دسترس‌پذیری بهتر کنم؟

برای هر قاب title توصیفی بنویسید، محتوای آن را در متن صفحه معرفی کنید و در صورت امکان لینک مستقیم جایگزین بدهید. کنترل‌های ویدئو باید با صفحه‌کلید کار کنند و تفاوت قاب با محتوای اصلی برای کاربر روشن باشد.

iframe راهی عملی برای اتصال صفحهٔ شما به یک سرویس خارجی است، به شرطی که مفهوم Embed را با تگ <embed> اشتباه نگیرید. URL معتبر، عنوان توصیفی، مجوز حداقلی، sandbox متناسب، نسبت تصویر، lazy loading و محتوای جایگزین، پنج جزء اصلی یک Embed قابل‌اعتماد هستند. بعد از پیاده‌سازی نیز Console، عملکرد موبایل، دسترس‌پذیری و هدرهای امنیتی را بررسی کنید.

مطالب پیشنهادی