الفرق بين المراجعتين لصفحة: «JavaScript/Document/images»

المراجعة الحالية بتاريخ 03:47، 22 مارس 2018

تُعيد الخاصيّة 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.

@@ سطر 11: / سطر 11: @@
 ==ملاحظات حول استعمال الخاصية==
-يُمكنك استعمال إمّا طريقة المصفوفات أو التّابع item‎‎‎‎()‎ على المجموعة المُعادة للوصول إلى عناصر المجموعة. المثالان التّاليّان لهما نفس التّأثير:
+يُمكنك استعمال إمّا طريقة المصفوفات أو التّابع [[JavaScript/item|<code>item‎‎‎‎()</code>‎]] على المجموعة المُعادة للوصول إلى عناصر المجموعة. المثالان التّاليّان لهما نفس التّأثير:
 <syntaxhighlight lang="javascript">
 firstImage = imageCollection(0);
@@ سطر 17: / سطر 17: @@
 firstImage = imageCollection[0];
 </syntaxhighlight>
-'''مُلاحظة:''' الخاصيّة <code>Document.images</code> مُتاحة على مُستندات HTML فقط.
+'''مُلاحظة:''' الخاصيّة <code>Document.images</code> مُتاحة في مُستندات HTML فقط.
 ==مثال==
-المثال التّالي يمرّ على قائمة الصّور ليَجد الصورة ذات الاسم "banner.gif".
+المثال التّالي يمرّ على قائمة الصّور ليَجد الصورة ذات الاسم <code>"banner.gif"</code>.
 <syntaxhighlight lang="javascript">
 var ilist = document.images;