التنقل بين العناصر في jQuery

من موسوعة حسوب
مراجعة 13:49، 19 مارس 2019 بواسطة جميل-بيلوني (نقاش | مساهمات) (إنشاء الصفحة.)
(فرق) → مراجعة أقدم | المراجعة الحالية (فرق) | مراجعة أحدث ← (فرق)

تتيح التوابع في هذا القسم بتحديد عناصر موجودة في موضع محدد والتنقل بينها.

‎.add()‎

إنشاء كائن jQuery جديد من العناصر المضافة إلى مجموعة من العناصر المطابقة.

‎.addBack()‎

يُضيف هذا التّابع مجموعة العناصر الموجودة سابقًا في المَكْدَس (stack) إلى المجموعة الحاليّة، مع إمكانيّة ترشيحها بشكل اختياري عن طريق مُحدِّد (selector).

‎.andSelf()‎

يُضيف هذا التّابع مجموعة العناصر الموجودة سابقًا في المَكدَس (stack) إلى المجموعة الحاليّة.

‎.children()‎

يحصل هذا التّابع على العناصر الأبناء لكل عنصر من مجموعة العناصر المُطابِقة.

‎.closest()‎

يحصل هذا التّابع على العنصر الأول الذي يُطابِق المُحدِّد عن طريق اختبار العنصر ذاته والانتقال إلى العناصر الأسلاف له في شجرة DOM.

‎.contents()‎

يحصل هذا التّابع على العناصر الأبناء لكل عنصر من مجموعة العناصر المُطابِقة، بما في ذلك عقد النصوص والتعليقات.

‎.end()‎

ينهي هذا التابع أحدث عملية الترشيح في السلسلة الحالية ويُعيد مجموعة العناصر المتطابقة إلى حالتها السابقة.

‎.eq()‎

تقليص مجموعة العناصر المتطابقة إلى تلك الموجودة في الفهرس المُحدَد.

‎.filter()‎

يقلص هذا التابع مجموعة العناصر المُطابقة إلى تلك التي تطابق المُحدد أو اجتازت اختبار الدالة.

‎.find()‎

يعيد العناصر السليلة لكل عنصر في المجموعة الحالية من العناصر المُطابقة، والتي تكون مرشحة بواسطة مُحدد، أو كائن jQuery، أو عنصر.

‎.first()‎

يُقلِّص هذا التابع مجموعة العناصر المطابقة إلى الأول في المجموعة.

‎.has()‎

يختار هذا التابع من العناصر التي حُدِّدَت مسبقًا العناصرَ السليلة منها التي تحقق الشروط المطلوبة في المحددات أو تطابق عنصر DOM.

‎.is()‎

التحقق من مجموعة العناصر المطابقة الحالية مقابل مُحدَّد أو عنصر أو كائن jQuery وإعادة القيمة true إذا تطابق أحد هذه العناصر على الأقل مع الوسائط المُدخلَة.

‎.last()‎

يزيل هذا التابع جميع العناصر المتطابقة من المجموعة باستثناء العنصر الأخير.

‎.map()‎

يمرِّر هذا التابع كل عنصر من عناصر المجموعة الحالية إلى دالة، وينشئ كائنًا جديدًا من النوع jQuery يحتوي على القيم المعادة.

‎.next()‎

يجلب هذا التابع العنصر الأخ الذي يلي مباشرةً كل عنصر في مجموعة العناصر المطابقة.

‎.nextAll()‎

يجلب هذا التابع جميع العناصر الأخوة لكل عنصر في مجموعة العناصر المطابقة، ويرشحها باستعمال محدِّد اختياريًّا.

‎.nextUntil()‎

يجلب هذا التابع جميع العناصر الأخوة التالية لكل عنصر والموجودة ضمن مجال محدَّد بدءًا من العنصر الأخ الذي يليه وحتى العنصر المطابق بوساطة المحدِّد أو عقدة DOM أو كائن jQuery (دون أن يدخل هذا العنصر ضمن المجال).

‎.not()‎

يحذف هذا التابع عناصر محدَّدة من مجموعة من العناصر المطابقة.

‎.offsetParent()‎

يعيد هذا التابع أقرب عنصر جد (ancestor) متموضع (positioned) للعنصر المطابق.

‎.parent()‎

يجلب هذا التابع العنصر الأب لكل عنصر في مجموعة العناصر المطابقة، ويمكن أن يرشِّح أيضًا تلك العناصر التي أعادها اختياريًا باستعمال محدِّد.

‎.parents()‎

يجلب هذا التابع جميع العناصر الآباء (العنصر الأب [parent] والأجداد [ancestors]) لكل عنصر في مجموعة العناصر المطابقة، ويمكن أن يرشِّح أيضًا تلك العناصر التي أعادها اختياريًا باستعمال محدِّد.

‎.parentsUntil()‎

يجلب هذا التابع العناصر الآباء (العنصر الأب [parent] والأجداد [ancestors]) الواقعة بين العنصر الأب الأقرب وحتى العنصر المتطابق باستعمال محدِّد، أو عقدة DOM، أو كائن jQuery (لا يدخل هذا العنصر ضمن المجال) وذلك لكل عنصر في مجموعة العناصر المطابقة، مع إمكانية ترشيحها بشكل اختياري عن طريق محدِّد.

‎.prev()‎

يجلب هذا التابع العنصر الأخ الذي يسبق مباشرةً كل عنصر في مجموعة العناصر المطابقة. إن مُرِّر للتابع محدِّد، فسيرشِّح جميع تلك العناصر التي يجدها أيضًا ويعيد ما تطابق منها.

‎.prevAll()‎

يجلب هذا التابع جميع العناصر الأخوة التي تسبق كل عنصر في مجموعة العناصر المطابقة، ثمَّ يرشحها اختياريًّا باستعمال محدِّد.

‎.prevUntil()‎

يجلب هذا التابع جميع العناصر الأخوة السابقة لكل عنصر من مجموعة العناصر المطابقة والموجودة ضمن مجال محدَّد بدءًا من العنصر الأخ الذي يسبقه مباشرةً وحتى العنصر المطابق بوساطة المحدِّد أو عقدة DOM أو كائن jQuery (دون أن يدخل هذا العنصر ضمن المجال).

‎.siblings()‎

يجلب هذا التابع جميع العناصر الأخوة لكل عنصر في مجموعة العناصر المطابقة مع إمكانية ترشيحها باستعمال محدِّد معطى.

‎.slice()‎

يقلِّص هذا التابع مجموعة العناصر المطابقة إلى مجموعة فرعيَّة موجودة في مجال محدَّد.