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
    }
}

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