طريقة querySelector() لمستند DOM HTML

التعريف والاستخدام

querySelector() يستعيد الطريقة الأول العناصر التي تطابق selector CSS.الأولالعناصر.

للحصول علىكلالمطابقات (ليس فقط المطابق الأول)، استخدم querySelectorAll().

إذا كان selector غير صالح، querySelector() و querySelectorAll() ستقوم بإطلاقها SYNTAX_ERR الاستثناءات.

المثال

مثال 1

الحصول على الأول <p>:

document.querySelector("p");

تجربة شخصية

مثال 2

الحصول على الأول يحتوي على الفئة "example":

document.querySelector(".example");

تجربة شخصية

مثال 3

الحصول على الأول <p> يحتوي على الفئة "example":

document.querySelector("p.example");

تجربة شخصية

مثال 4

غير النص الخاص بالعنصر الذي يحتوي على id="demo":

document.querySelector("#demo").innerHTML = "Hello World!";

تجربة شخصية

مثال 5

اختر الأول <p> يكون العنصر الأب له <div>:

document.querySelector("div > p");

تجربة شخصية

مثال 6

اختر الأول <a> يحتوي على الخاصية "target":

document.querySelector("a[target]");

تجربة شخصية

مثال 7

اختر الأول <h3> أو الأول <h4>:

<h3>عنصر h3</h3>
<h4>عنصر h4</h4>
document.querySelector("h3, h4").style.backgroundColor = "red";

تجربة شخصية

مثال 8

اختر الأول <h3> أو الأول <h4>:

<h4>عنصر h4</h4>
<h3>عنصر h3</h3>
document.querySelector("h3, h4").style.backgroundColor = "red";

تجربة شخصية

النحو

document.querySelector(cssSelectors)

المعلمات

المعلمات الوصف
cssSelectors

مطلوب. selector CSS واحد أو أكثر.

selector CSS يقوم بتحديد عناصر HTML بناءً على id، الفئات، النوع، الخصائص، قيم الخصائص وما إلى ذلك.

للحصول على قائمة كاملة، يرجى زيارة دليل مرجع مختار CSS.

بالنسبة للعديد من selectors، استخدم نقاط عالية لفصل كل selector (انظر مثال أعلى الصفحة).

القيمة المطلوبة

النوع الوصف
المعلمات

NodeList يحتوي على العنصر الأول الذي يطابق selector CSS.

إذا لم يتم العثور على أي تطابق، يتم العودة إلى null.

فارق بين HTMLCollection و NodeList

NodeList و HTMLcollection مماثلة جدًا.

كلاهما هو مجموعة من العناصر (النود) التي تم استخراجها من الوثيقة (النص) كجمع شبيه بالقائمة (النص) يمكن الوصول إليها من خلال أرقامها. يبدأ الرقم من 0.

كلاهما: length الخصائص، التي تعود قائمة (مجموعة) من العناصر في القائمة (المجموعة).

HTMLCollection هي:عنصر الوثيقةالمجموعة.

NodeList هي:عقدة الوثيقةمجموعة من (عنصر النص، عقدة الخاصية، عقدة النص).

يمكن الوصول إلى مشاريع HTMLCollection من خلال أسمائهم أو id أو أرقامهم.

يمكن الوصول إلى مشاريع NodeList فقط من خلال أرقامها.

HTMLCollection دائمًا:حيةالمجموعة.

على سبيل المثال: إذا أضفت عنصر <li> إلى قائمة DOM، فإن قائمة HTMLCollection ستتغير أيضًا.

عادة NodeList:ثابتةالمجموعة.

على سبيل المثال: إذا أضفت عنصر <li> إلى قائمة DOM، فإن قائمة NodeList لن تتغير.

getElementsByClassName() و getElementsByTagName() تعود جميع الطرق NodeList حية.

querySelectorAll() تعود الطريقة NodeList ثابتة.

childNodes الخصائص تعود NodeList حية.

دعم المتصفحات

document.querySelector() هي خاصية DOM Level 1 (1998).

يدعم جميع المتصفحات:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
الدعم 9-11 الدعم الدعم الدعم الدعم

الصفحات ذات الصلة

دليل:

مختار CSS

دليل مرجع مختار CSS

دليل مرجع NodeList DOM HTML

طريقة QuerySelector:

طريقة querySelector():

طريقة querySelectorAll():

طريقة GetElement:

طريقة getElementById()

طريقة getElementsByTagName()

طريقة getElementsByClassName()