jQuery الترحيل - طريقة .parentsUntil()
مثال
البحث عن العناصر الأبوية لـ <li class="item-a"> حتى <ul class="level-1">، وقم بتعيين لون الخلفية لهم إلى اللون الأحمر. كما يجب العثور على جميع العناصر الأبوية للـ <li class="item-2"> التي تحتوي على اسم فئة "yes" حتى <ul class="level-1">، وقم بتعيين حوافها إلى اللون الأزرق:
$("li.item-a");.parentsUntil(".level-1"); .css("background-color", "red"); $("li.item-2");.parentsUntil($("ul.level-1"), ".yes"); .css("border", "3px solid blue");
تعريف واستخدام
يستخدم .parentsUntil() لتحديد العناصر الأبوية لكل عنصر في مجموعة العناصر الم匹配ة، حتى العنصر الذي يتطابق مع التعبير عن الملفات المختارة أو العنصر أو كائن jQuery المحدد.
القواعد 1
.parentsUntil(selector,filter)
المواصفات | وصف |
---|---|
selector | اختياري. قيمة سلسلة، تحدد أين يجب وقف تطبيق فرز العناصر الأبوية. |
filter | اختياري. قيمة سلسلة، تحتوي على تعبير عن الملفات المختارة المستخدم لتحديد العناصر. |
القواعد 2
.parentsUntil(element,filter)
المواصفات | وصف |
---|---|
element | اختياري. عقدة DOM أو كائن jQuery، يحدد أين يجب وقف تطبيق فرز العناصر الأبوية. |
filter | اختياري. قيمة سلسلة، تحتوي على تعبير عن الملفات المختارة المستخدم لتحديد العناصر. |
شرح مفصل
إذا تم تقديم كائن jQuery يمثل مجموعة عناصر DOM، يسمح لـ .parentsUntil() ببحث العناصر الأبوية لهذه العناصر في شجرة DOM حتى وصوله إلى العنصر الذي تتطابق مع التعبير عن الملفات المختارة (الملف المقدم إلى الطريقة). يحتوي الكائن jQuery الذي يتم العودة به على جميع العناصر الأبوية، ولكن لا يشمل العنصر الذي يتطابق مع التعبير عن الملفات المختارة أو العنصر أو كائن jQuery المحدد لـ .parentsUntil().
إذا لم تكن العناصر متطابقة أو لم يتم تطبيق تعبير الملفات المختارة، سيتم اختيار جميع العناصر الأبوية؛ في هذه الحالة، العناصر التي يتم اختيارها بواسطة هذه الطريقة هي نفسها التي يتم اختيارها بواسطة .parents() عند عدم تقديم تعبير عن الملفات المختارة.
لـ jQuery 1.6، يمكن استخدام عناصر DOM أو كائنات jQuery بدلاً من التعبير عن الملفات المختارة كأول مفتاح لـ .parentsUntil().
يستقبل هذا الطريقة تعبير اختياري للتعبير عن الملفات المختارة كثاني مفتاحها. إذا تم تطبيق هذا المفتاح، سيتم فرز العناصر من خلال التحقق من مطابقة العناصر مع هذا التعبير عن الملفات المختارة.