شئTableRow منتسب با يك عنصرHTML <tr> ميباشد .باشئTableRow ميتوان عنصرHTML <tr>صفحه را بصورت اقدامات شئ گرائي مديريت كرد. عنصر<tr> براي تعريف سطر هاي جدول استفاده ميشود.
با متدgetElementById() ميتوان بعنصرHTML <tr> دسترسي پيداكرد.
مثال ـ دسترسي به عنصرHTML <tr> باid="myTr"
var x = document.getElementById("myTr");
با متدdocument.createElement() ميتوان شئTableRow را ايجاد نمود.
مثال ـ ايجاد شئTableRow
var x = document.createElement("TR");
مجموعه | شرح |
---|---|
cells | مجموعه از عناصر<td> , <th> برگشت ميدهد . |
ويژگي | شرح |
---|---|
align |
توسطHTML 5 پشتيباني نمي شود .بجايش ازstyle.textAlign استفاده ميشود.
تراز افقي محتوي داخل عنصرtr را تنظيم ويا برگشت ميدهد. |
bgColor |
توسطHTML 5 پشتيباني نمي شود .بجايش ازstyle.backgroundColor استفاده ميشود.
رنگ پس زمينه سطر جدول را تنظيم ويا برگشت ميدهد. |
ch |
توسطHTML 5 پشتيباني نمي شود.
يك كراكتر تراز را در داخل عنصرtr تنظيم ويا برگشت ميدهد . |
chOff |
توسطHTML 5 پشتيباني نمي شود.
افست افقي ويژگيch را تنظيم ويا برگشت ميدهد . |
height |
توسطHTML 5 پشتيباني نمي شود .بجايش ارstyle.height استفاده شود .
ارتفاع سطر جدول را تنظيم ويا برگشت ميدهد. |
rowIndex | موقعيت يا انديس سطر را در مجموعه سطرهاي يك جدول برگشت ميدهد. |
sectionRowIndex | موقعيت يك سطر را در مجموعه سطرهايtbody,thead,tfoot برگشت ميدهد . |
vAlign |
توسطHTML 5 پشتيباني نمي شود .بجايش ازstyle.verticvalAlign استفاده شود .
تراز عمودي محتوي را در يك عنصرtr تنظيم ويا برگشت ميدهد. |
متد | شرح |
---|---|
deleteCell | سلولي را از سطر جاري جدول حذف مينمايد. |
insertCell | سلولي به سطر جاري جدول اضافه مينمايد. |
بعضي از ويژگي ها كه ممكن روي عناصر ديگر مشابه باشند، مطابق جدول ويژگي در صفحات ديگر تشريح شده باشند .اما جند ويژگي آن درهمين صفحه تشريح ميگردند.
ويژگيTableRow rowIndex انديس يا موقعيت عنصر <tr> مرتبط با شئ TableRow در مجموعه سطرهاي جدول برگشت ميدهد .موقعيت سطرها در مجموعه هماني است كه در كداصلي وجود دارد.
مثال ـ با كليك روي هر سطر جدول موقعيت آنرا نمايش ميدهد.
alert("Row index is: " + x.rowIndex);
مثال ـ بدست آوردن موقعيت ويا انديس تمام سطرهاي يك جدول
var x = document.getElementsByTagName("tr"); var txt = ""; var i; for (i = 0; i < x.length; i++) { txt = txt + "The index of Row "+(i+1)+" is: "+x[i].rowIndex+"<br>"; }
توجه ـ مثال نمونه فقط براي يك جدول در صفحه درست كارميكند .يعني صفحه فقط بايد شامل يك صفحه باشد.
هرجدولي درHTML ممكن است داراي بخش هائي مثل <tbody>, <tfoot> , <thead> باشد .هركدام از آنها ميتوانند داراي عنصرtr باشند .اين ويژگي ميتواند موقعيت سطرها را در بخش هاي فوق برگشت دهد.
مثال ـ با كليك روي سط انديس وياموقعيت آنرا در بخش مربوطه نمايش ميدهد
alert("Section row index is: " + x.sectionRowIndex);
مثال ـ برگشت موقعيت سطر ها نسبت به بخش مربوطه سطر
var x = document.getElementsByTagName("tr"); var txt = ""; var i; for (i = 0; i < x.length; i++) { txt = txt + "The index of Row "+(i+1)+" is: "+x[i].sectionRowIndex+"<br>"; }
شئTableRow از ويژگي ها ورويداد هاي استاندارد پيروي ميكند.