عنصر HTMLCollection XML DOM

عنصر HTMLCollection

HTMLCollection یک رابط است که مجموعه‌ای از عناصر HTML را نشان می‌دهد و روش‌ها و ویژگی‌هایی را ارائه می‌دهد که می‌توان از طریق آن‌ها لیست را جستجو کرد.

HTMLCollection در HTML DOM زنده است؛ اگر مستند پایه تغییر کند، این تغییرات از طریق همه HTMLCollection‌ها بلافاصله نمایش داده می‌شوند.

هر یک از موارد زیر (و ویژگی‌های مشخص شده توسط آن‌ها) HTMLCollection را بازمی‌گرداند:

  • Document (images, applets, links, forms, anchors)
  • form (elements)
  • map (areas)
  • select (options)
  • table (rows, tBodies)
  • tableSection (rows)
  • row (cells)

بسیاری از ویژگی‌های HTMLDocument که به عنوان HTMLCollection هستند، راه‌حل‌های راحت‌ای برای دسترسی به عناصر مستند مانند فرم‌ها، تصاویر و لینک‌ها ارائه می‌دهند.form.elements و select.options همه HTMLCollection هستند. HTMLCollection همچنین امکان جستجو Table ترانه‌های مختلف و TableRow یک روش راحت برای دسترسی به سلول‌های مختلف است.

همانطور که قبلاً ذکر شد، HTMLCollection یک مجموعه از عناصر HTML با روش‌ها است، که می‌توان از طریق موقعیت عناصر در مستند یا ویژگی‌های id و name آن‌ها عناصر را به دست آورد. در JavaScript، رفتار HTMLCollection مانند یک آرایه خواندنی است و می‌توان از روش‌های آرایه JavaScript برای دسترسی به HTMLCollection، از طریق شماره یا نام، استفاده کرد، بدون نیاز به فراخوانی روش item()و روش namedItem().

HTMLCollection خواندنی است و نمی‌توان به آن عناصر جدید اضافه کرد، حتی با استفاده از نحوه‌ی نوشتن آرایه‌های JavaScript نیز ممکن نیست.

HTMLCollection و موضوع NodeListبسیار مشابه هستند، اما ممکن است هر دو از طریق شماره یا نام به عنوان شاخص استفاده شوند.

ویژگی‌های HTMLCollection

ویژگی توضیح
cssRules یک ویژگی خواندنی است که یک عدد صحیح نشان‌دهنده طول لیست را بازمی‌گرداند (یعنی تعداد عناصر موجود در مجموعه).

مетодهای HTMLCollection

روش توضیح
item() عنصر مشخصی را که در موقعیت مشخصی قرار دارد، از مجموعه بازمی‌گرداند (نقطه).
namedItem() عناصری را که ویژگی name یا id با مقدار مشخصی دارند، از مجموعه بازمی‌گرداند (نقطه).

مثال

var c = document.forms;		//این یک HTMLCollection موضوع form است
var firstform = c[0];		//می‌توان به عنوان یک آرایه عددی استفاده کرد
var lastform = c[c.length-1];	//ویژگی length تعداد عناصر را برمی‌گرداند
var address = c["address"];		//می‌توان به عنوان یک آرایه مرتبط استفاده کرد
var address = c.address;		//JavaScript این نمایش‌ها را اجازه می‌دهد

صفحات مرتبط

دستورالعمل مرجع DOM XMLموضوع HTMLDocument

دستورالعمل مرجع DOM XMLموضوع NodeList

دستورالعمل مرجع:دستورالعمل مرجع HTML DOM