Document.images

تُعيد الخاصيّة Document.images مجموعة الصور الموجودة في مُستند HTML الحاليّ.

البنية العامة

var imageCollection = document.images;

القيمة

مجموعةٌ من النّوع HTMLCollection تحتوي على قائمة بجميع الصّور الموجودة في المُستند الحالي. كلّ عنصر في المجموعة يُعدّ من النّوع HTMLImageElement ويُمثّل عنصر صورة واحد.

ملاحظات حول استعمال الخاصية

يُمكنك استعمال إمّا طريقة المصفوفات أو التّابع item‎‎‎‎()‎ على المجموعة المُعادة للوصول إلى عناصر المجموعة. المثالان التّاليّان لهما نفس التّأثير:

firstImage = imageCollection(0);

firstImage = imageCollection[0];

مُلاحظة: الخاصيّة Document.images مُتاحة في مُستندات HTML فقط.

مثال

المثال التّالي يمرّ على قائمة الصّور ليَجد الصورة ذات الاسم "banner.gif".

var ilist = document.images;

for(var i = 0; i < ilist.length; i++) {
    if(ilist[i].src == 'banner.gif') {
        // هنا العنصر الذي  يُمثّل الصورة
        // banner.gif
    }
}

مصادر ومواصفات

• مواصفة HTML Living Standard.
• مواصفة Document Object Model (DOM) Level 2 HTML Specification.