ویژگی sandbox <iframe> در HTML
تعریف و نحوه استفاده
sandbox ویژگی یک مجموعه اضافی از محدودیت‌ها را برای محتوای داخل <iframe> فعال می‌کند.
وقتی که sandbox وقتی که ویژگی وجود دارد، آن را:
- محتوای به عنوان منبع منحصر به فرد در نظر گرفته می‌شود
- ممانعت از ارسال فرم
- ممانعت از اجرای اسکریپت
- ممنوعیت API
- ممانعت از لینک‌ها به محیط‌های مرورگر دیگر
- ممانعت از استفاده از پلاگین‌ها (از طریق <embed>، <object>، <applet> یا روش‌های دیگر)
- ممانعت از هدایت محتوای محیط مرورگر بالاتر
- ممانعت از قابلیت‌های خودکار (مثلاً پخش خودکار ویدئو یا خودکار تمرکز بر کنترل فرم)
sandbox مقدار ویژگی می‌تواند خالی باشد (در این صورت تمام محدودیت‌ها اعمال می‌شوند) یا لیستی از مقادیر پیش‌تعریف شده با جداکننده فضای خالی باشد که محدودیت‌های خاصی را حذف می‌کند.
مثال
مثال 1
<iframe> با محدودیت‌های اضافی:
<iframe src="demo_iframe_sandbox.htm" sandbox></iframe>
مثال 2
اجازه می‌دهد که <iframe> ساندبoks فرم ارسال شود:
<iframe src="demo_iframe_sandbox_form.htm" sandbox="allow-forms"></iframe>
مثال 3
اجازه می‌دهد که <iframe> ساندبoks脚本:
<iframe src="demo_iframe_sandbox_origin.htm" sandbox="allow-scripts"></iframe>
نحوه استفاده
<iframe sandbox="value">
مقدار ویژگی
| مقدار | توضیح |
|---|---|
| "" (بدون ارزش) | تمام محدودیت‌های زیر را اعمال کنید. |
| allow-forms | اجازه می‌دهد که فرم‌ها ارسال شوند. |
| allow-modals | اجازه می‌دهد که پنجره‌های موقت باز شوند. |
| allow-orientation-lock | اجازه می‌دهد که جهت صفحه نمایش قفل شود. |
| allow-pointer-lock | اجازه می‌دهد از API Pointer Lock استفاده شود. |
| allow-popups | اجازه می‌دهد پنجره‌های پاپ‌آپ باز شوند. |
| allow-popups-to-escape-sandbox | اجازه می‌دهد پنجره‌های پاپ‌آپ یک پنجره جدید باز کنند، بدون اینکه به سانDBOX متصل شوند. |
| allow-presentation | اجازه می‌دهد جلسه نمایش آغاز شود. |
| allow-same-origin | اجازه می‌دهد محتوای iframe به عنوان منبع مشابه با مستند شامل آن در نظر گرفته شود. |
| allow-scripts | اجازه می‌دهد اسکریپت‌ها اجرا شوند. |
| allow-top-navigation | اجازه می‌دهد محتوای iframe به محیط بالاترین مرورگر هدایت شود. |
| allow-top-navigation-by-user-activation | اجازه می‌دهد محتوای iframe به محیط بالاترین مرورگر هدایت شود، اما فقط در صورت درخواست کاربر. |
پشتیبانی مرورگر
اعداد در جدول نشان‌دهنده نسخه اولیه مرورگرهایی است که این ویژگی را کامل پشتیبانی می‌کنند.
| Chrome | Edge | Firefox | Safari | Opera |
|---|---|---|---|---|
| Chrome | Edge | Firefox | Safari | Opera |
| 4.0 | 10.0 | 17.0 | 5.0 | 15.0 |
