‎ويژگي هاي شئIFrame

‎شئIFrame كه درجاوااسكريپت ايجاد ميشود، مرتبط با يكي از عناصرHTML ‎<iframe>‎ ‎صفحه ميباشد .اين شئ داراي ويژگي هاي همان عنصر‎<iframe>‎ است كه ميتوان با فرمت ‎شئ گرائي با شئ مذكور روي آن اثر گذاشت .بعبارتي ميتوان مقادير ويژگيهاي آنرا تنظيم ويا بدست ‎آورد.

‎جدول ويژگي هاي شئIFrame مطابق زير بوده ، ودراين صفحه هركدام دربخش داخلي تشريح ميشوند . ‎لينك بخش داخلي هم در جدول وجود دارد.

‎ويژگيIFrame align

‎ويژگيIFrame align در HTML5 پشتيباني نميشود وبجاي آن از ‎style.cssFloat‎ ‎استفاده ميگردد .بهمين دليل اين ويژگي تشريح ميگردد.

‎ويژگيStyle cssFloat

‎ويژگيstyle.cssFloat تراز افقي يك عنصر را تنظيم ويابرگشت ميدهد .

‎مثال ـ دراين مثال تصويري با كليك روي دكمه هاي تنظيمي بسمت چپ ويا راست متن قرار ميگيرد.

function floatRight() {
  document.getElementById("myImg").style.cssFloat = "right";
}

function floatLeft() {
  document.getElementById("myImg").style.cssFloat = "left";
}

‎توجه نمائيد كه اين ويژگي هم ميتواند براي شئIFrame بكار گرفته شود، مشابه با تصويرمثال .

‎فرمت استفاده ـSyntax

‎برگشت مقدار ويژگيcssFloat
object.style.cssFloat

‎تنظيم مقدار ويژگيcssFloat
object.style.cssFloat="left | rigth | none| initial | inherit"

‎مقادير ويژگي ـProperty Values

‎مثال ـ ويژگيcssfloat عنصر div را به ‎"left‎"‎تغيير ميدهد .

document.getElementById("myDIV").style.cssFloat = "left";

‎ويژگيIFrame contentDocument

‎ويژگيcontentDocument يك شئ document توليد شده توسط يك frame ويا.iframe را برگشت ‎ميدهد .اين ويژگي را ميتوان در پنجره ميزبان براي دسترسي به شئdocument كه متعلق به فريم و ‎يا آيفريم است ،استفاده كرد.

‎مثال ـ مثالي از مرورگرمتقاطع در مورد نحوي تغيير رنگ پس زمينه سند مجود در آيفريم.

var x = document.getElementById("myframe");
var y = (x.contentWindow || x.contentDocument);
if  (y.document)y = y.document;
y.body.style.backgroundColor = "red";

‎فرمت استفاده ـSyntax

iframeObject.contentDocument

‎مثال ـ چگونگي دسترسي بيك سندiframe و تغيير رنگ آن

var x = document.getElementById("myframe");
var y = x.contentDocument;
y.body.style.backgroundColor = "red";

‎ويژگيIFrame contentWindow

‎ويژگيIFrame contentWindow شئ پنجره توليد شده توسط يك عنصر iframe رابرگشت ميدهد . ‎از طريق اين شئ ميتوان به شئ سند وعناصر آن دسترسي پيداكرد.

‎مثال ـ مثالي از مرورگرمتقاطع در مورد نحوي تغيير رنگ پس زمينه سند موجود درiframe

var x = document.getElementById("myframe");
var y = (x.contentWindow || x.contentDocument);
if  (y.document)y = y.document;
y.body.style.backgroundColor = "red";

‎فرمت استفاده ـSyntax

iframeObject.content.Window

‎مثال ـ مثالي ديگر ازتغيير رنگ پس زمينهiframe

var x = document.getElementById("myframe");
var y = x.contentWindow.document;
y.body.style.backgroundColor = "red";

‎دراين مثال اشياء به ترتيب مطابق زيرند:

• x‎ـ شئ آيفريم
• y‎ـ شئ سند پنجره
• y.body‎ـ شئ بدنه براي تغيير رنگ پس زمينه

‎ويژگيIFrame frameBorder

‎ويژگيIFrame frameBorder درHTML5 پشتيباني نمي شود .بجايش از‎sryle.border‎ ‎استفاده ميگردد، بهمين دليل اين ويژگي تشريح ميشود.

‎ويژگيstyle.border

‎ويژگي‎style.border‎ حد اكثر سه ويژگي مرزي‎(border)‎ مجزا را بصورت ‎مختصرتنظيم ويا برگشت ميدهد.

‎با اين ويژگي ، ميتوان يكي يا بيشتر از موارد زيرا تنظيم ويابرگشت داد:

• boder-‎width‎ـ عرض مرز
• border-‎style‎ـ سبك مرز
• border-‎color‎ـ رنگ مرزي

‎مثال ـ افزايش مرز براي عنصرdiv

document.getElementById("myDiv").style.border = "thick solid #0000FF";

‎فرمت استفاده ـSyntax

‎فرمت استفاده براي برگشت
object.style.border

‎فرمت استفاده براي تنظيم ويژگي
object.boder="with style color |initial |inherit"

‎مقادير ويژگي ـProperty Values

‎مثال ـ عرض، استايل و رنگ عنصرdiv راتغيير ميدهد .

document.getElementById("myDiv").style.border = "thin dotted red";

‎ويژگيIFrame height

‎ويژگيIFrame height ارتفاع يك عنصر iframe را تنظيم ويا برگشت ميدهد .

‎مثال ـ ارتفاع يك عنصرiframe راتغيير ميدهد .

document.getElementById("myFrame").height = "400";

‎فرمت استفاده ـSyntax

‎برگشت مقدار ويژگي
iframeObject.height

‎تنظيم مقدار ويژگي
iframeObject.height=pixels

‎مثال ـ برگشت ارتفاعiframe

var x = document.getElementById("myFrame").height;

‎ويژگيIFrame marginHeight

‎ويژگيIFrame marginHeight در HTML5 پشتيباني نميشود، بهمين دليل ويژگي ‎style.margin‎تشريح وبجاي آن بكار گرفته ميشود .

‎ويژگيstyle.margin

‎ويژگي‎style.margin‎ مقادير حواشي يك عنصر را تنظيم ويا برگشت ميدهد . اين ويژگي ‎ميتواند يك تا چهار مقدار مطابق زير داشته باشد:

• ‎يك مقدار ـ مثل‎div (margin: 50px)‎ كه همه چهار حاشيه داراي مقدار يكسان هستند .
• ‎دو مقداري ـ مثل‎ div (margin: 50px 10px)‎حاشيه بالا وپائين‎ 50px‎ و ‎وحاشيه چپ وراست‎10px‎
• ‎سه مقداري ـ مثل‎div (margin: 50px 10px 20px)‎ حاشه بالا‎50px‎ حاشيه چپ ‎و راست‎10px‎ وحاشيه پائين‎20px‎
• ‎چهار مقداري ـ مثال‎ div (margin: 50px 10px 20px 30px)‎ حاشيه بالا ‎50px‎چپ‎10px‎ راست ‎20px‎ وحاشيه پائين ‎30px‎

‎مثال ـ تنظيم هر چهار حاشيه عنصرdiv

document.getElementById("myDiv").style.margin = "50px 10px 20px 30px";

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
object.style.margin

‎مقادير ويژگي ـProperty Values

‎مثال ـ تغيير هر جهار حاشيه عنصرdiv به ‎‎"25px‎"‎

document.getElementById("myDiv").style.margin = "25px";

‎مثال ـ برگشت ميدهد حاشيه هاي عنصرdiv

alert(document.getElementById("myDiv").style.margin);

‎ويژگيIFrame name

‎ويژگيIFrame name مقدار ويژگي نام عنصر ‎<ifram>‎ مرتبط را تنظيم ويابرگشت ميدهد . ‎ويژگيname نامي را براي عنصرiframe مشخص مي نمايد . اين نام در جاوااسكريپت براي مراجعه به ‎آن عنصر بكار گرفته ميشود .ويژگي نام در عناصر مختلفي از جمله‎<a>,<form>,...‎ ‎وجود دارد.

‎مثال ـ دريافت نام يكiframe

var x = document.getElementById("myFrame").name;

‎فرمت استفاده ـSyntax

‎برگشت مقدار ويژگي
iframeObject.name

‎تنظيم مقدار ويژگي
iframeObject.name=name

‎مثال ـ نام يك عنصرiframe را تغيير ميدهد .

document.getElementById("myFrame").name = "newIframeName";

‎ويژگيIFrame sandbox

‎ويژگيIFrame sandbox مقدار ويژگي sandbox عنصر iframe مرتبط را برگشت ميدهد .ويژگي فوق ‎براي فعال كردن محدويت هاي امنيتي برايiframe با محتوي غيرقابل اعتماد ‎)‎ مثل ‎اسكريپت ها وفرم ها‎(‎ استفاده ميشود .

‎اگر بعنوان يك رشته خالي مشخص شود، ممكن است محدوديت هاي اضافي در محتوي درون خطي مطرح ‎شود.

‎اين ويژگي فقط خواندني است.

‎مثال ـ برگشت مقدار ويژگيsandbox

var x = document.getElementById("myFrame").sandbox;

‎فرمب استفاده ـSyntax

iframeObject.sandbox

‎ويژگيIFrame seamless

‎ويژگيIFrame seamless مشخص ميكند كه عنصر iframe بدون مرز واسكرول در سند ظاهر ميشود . ‎اگر چنين موردي صادق باشد، به نظر ميرسد كهiframe بخش از سند است .

‎مثال ـ بررسي ميشود كهiframe مشابه بخشي از سند است .

var x = document.getElementById("myFrame").seamless;

‎اين ويژگي در مرورگرهاي معررف پشتيباني نمي شود.

‎مقادير اين ويژگي‎true/false‎ مطابق زير :

• true‎ـ ايفرم مشابه با متن سند بدون مرز واسكرول ظاهر ميشود .
• false‎ـ آيفرم با مرز واسكرول ظاهر ميشود .

‎ويژگيIFrame src

‎ويژگيIFrame src مقدار ويژگي src عنصر ‎<iframe>‎ مرتبط را تنظيم ويا برگشت ‎ميدهد .اين ويژگي آدرسurl سندي كه بايد در عنصرiframe نمايش داده شود، مشخص ميكند .

‎مثال ـ تغيير آدرسurl سند عنصر iframe

document.getElementById("myFrame").src = "https://wwf.org";

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
iframeObject.src

‎فرمت تنظيم ويژگي
iframeObject.src=URL

‎مقادير ويژگي ـProperty Values

‎مثال ـ دريافت آدرسurl كه در يكiframe نمايش ميشود .

var x = document.getElementById("myFrame").src;

‎ويژگيIFrame srcdoc

‎ويژگيIFrame srcdoc مقدار ويژگي عنصر‎<ifram>‎ مرتبط با شئ IFrame را تنظيم و ‎برگشت ميدهد .اين ويژگي محتويHTMl درون خطي صفحه بايد براي فريم نشان داده شود، مشخص ‎ميكند.

‎اگر مرورگري از ويژگيsrcdoc پشتيباني كند، محتوي مشخص شده در src را لغو ميكند .اگر آنرا ‎پشتيباني نكند، فايل مشخص شده درsrc درآن درصورت وجود، نمايش داده ميشود.

‎مثال ـ محتويHTML نشان داده شده در iframe را تغيير ميدهد .

document.getElementById("myFrame").srcdoc = "<p>Some new content inside the iframe!</p>";

‎پشتيباني مرورگرBrowser Support -‎

‎ويژگي
srcdoc	20.0	not supported	25.0	6.0	15.0

‎فرمت استفاده ـSyntax

‎فرمت برگشت ويژگي
iframeObject.srcdoc

‎فرمت تنظيم ويژگي
iframeObject.srcdo=HTML_code

var x = document.getElementById("myFrame").srcdoc;

document.getElementById("myFrame").width = "400";

var x = document.getElementById("myFrame").width;