الفرق بين المراجعتين ل"jQuery/Topics"
ط (تعديل ترتيب المواضيع) |
جميل-بيلوني (نقاش | مساهمات) |
||
سطر 45: | سطر 45: | ||
===<code>[[jQuery/pushStack|.pushStack()]]</code>=== | ===<code>[[jQuery/pushStack|.pushStack()]]</code>=== | ||
يضيف هذا التابع مجموعة من عناصر DOM إلى مُكدِّس jQuery. | يضيف هذا التابع مجموعة من عناصر DOM إلى مُكدِّس jQuery. | ||
+ | ==المحددات== | ||
+ | توفر مكتبة jQuery مجموعة قوية من الأدوات لمطابقة العناصر وتحديدها في الصفحة، إذ استفادت المكتبة من CSS بجميع إصداراتها. | ||
− | + | من أجل استعمال المحارف الخاصة (مثل <code>!"#$%&'()*+,./:;<=>?@[\]^`{|}~</code>) كجزء صرف من الاسم المراد تحديده، يجب أن تهرب تلك المحارف عبر \\. على سبيل المثال، إن كان اسم العنصر المراد تحديده هو id="foo.bar"، يمكنك تحديده عبر المُحدِّد $("#foo\\.bar"). تحوي مواصفات CSS القياسية (أي W3C CSS specification) [https://www.w3.org/TR/CSS21/syndata.html#value-def-identifier مجموعة كاملة من القواعد المتعلقة بالمحددات الصالحة]. هنالك أيضًا مقالة مفيدة لصاحبها Mathias Bynens تتحدث عن [https://mathiasbynens.be/notes/css-escapes تهريب سلسلة من الحارف في CSS]. | |
− | |||
===[[jQuery/all selector|محدد جميع العناصر]]=== | ===[[jQuery/all selector|محدد جميع العناصر]]=== | ||
سطر 234: | سطر 235: | ||
===[[jQuery/visible selector|المحدد <code rel="mw:WikiLink" title="jQuery/visible selector" href="jQuery/visible_selector">:visible</code>]]=== | ===[[jQuery/visible selector|المحدد <code rel="mw:WikiLink" title="jQuery/visible selector" href="jQuery/visible_selector">:visible</code>]]=== | ||
تحديد كل العناصر المرئية. | تحديد كل العناصر المرئية. | ||
− | |||
− | |||
==التنقل بين العناصر== | ==التنقل بين العناصر== | ||
+ | تتيح التوابع في هذا القسم بتحديد عناصر موجودة في موضع محدد والتنقل بينها. | ||
===<code>[[jQuery/add|.add()]]</code>=== | ===<code>[[jQuery/add|.add()]]</code>=== | ||
سطر 321: | سطر 321: | ||
===<code>[[jQuery/slice|.slice()]]</code>=== | ===<code>[[jQuery/slice|.slice()]]</code>=== | ||
يقلِّص هذا التابع مجموعة العناصر المطابقة إلى مجموعة فرعيَّة موجودة في مجال محدَّد. | يقلِّص هذا التابع مجموعة العناصر المطابقة إلى مجموعة فرعيَّة موجودة في مجال محدَّد. | ||
− | |||
− | |||
==تعديل العناصر== | ==تعديل العناصر== | ||
+ | جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل عنصر بأكمله (أو مجموعة من العناصر) وبذاته مثل الإضافة، أو النسخ، أو الحذف، أو الإزالة ...إلخ. (إن كنت تبحث عن توابع تعدل خاصية عنصر، فانتقل إلى قسم «تعديل الخاصيات»). | ||
===<code>[[jQuery/after|.after()]]</code>=== | ===<code>[[jQuery/after|.after()]]</code>=== | ||
سطر 399: | سطر 398: | ||
===<code>[[jQuery/wrapInner|.wrapInner()]]</code>=== | ===<code>[[jQuery/wrapInner|.wrapInner()]]</code>=== | ||
تغليف شيفرة HTML حول محتوى كل عنصر في مجموعة العناصر المُطابقة. | تغليف شيفرة HTML حول محتوى كل عنصر في مجموعة العناصر المُطابقة. | ||
− | + | ==تعديل الخاصيات== | |
− | + | جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل خاصية محددة لعنصر (أو مجموعة من العناصر). توصف أغلبية هذه التوابع على أنها «توابع ضابطة» (setters)، إذ تضبط وتغير قيمة خاصية محددة. هنالك قلة من هذه التوابع توصف على أنها «توابع جالبة» (getters) مثل <code>[[jQuery/attr|.attr()]]</code> و <code>[[jQuery/html|.html()]]</code> و <code>[[jQuery/val|.val()]]</code> لأنها تجلب معلومات من عناصر DOM لاستخدامها لاحقًا. (إن كنت تود إجراء تعديل على العنصر نفسه، فارجع إلى قسم «<nowiki/>[[jQuery#.D8.AA.D8.B9.D8.AF.D9.8A.D9.84 .D8.A7.D9.84.D8.B9.D9.86.D8.A7.D8.B5.D8.B1|تعديل العناصر]]»). | |
− | == | ||
===<code>[[jQuery/addClass|.addClass()]]</code>=== | ===<code>[[jQuery/addClass|.addClass()]]</code>=== |
مراجعة 12:36، 19 مارس 2019
أساس jQuery
.length
تعيد هذه الخاصِّيَّة عدد العناصر الموجودة في كائن jQuery.
.jquery
يُسند إلى هذه الخاصِّية سلسلة نصية تحتوي على رقم إصدار jQuery.
jQuery()
تعيد هذه الدالة مجموعةً من العناصر المطابقة التي إمَّا وُجدَت في شجرة DOM بناءً على الوسائط المُمرَّرة، أو أنشئت بتمرير سلسلة نصية تحتوي على محتوى HTML.
jQuery.contains()
يتحقَّق هذا التابع إن كان عنصر DOM معيَّن هو عنصر سليل (ancestor) من عنصر DOM آخر.
jQuery.cssHooks()
يتعلَّق هذا التابع بـ jQuery مباشرةً للتحكم بكيفيَّة استعادة أو ضبط قيم خاصِّيَّات CSS محدَّدة، أو توحيد أسماء خاصِّيَّات CSS، أو إنشاء خاصِّيَّات CSS مخصَّصة.
jQuery.cssNumber()
يعيد هذا التابع كائنًا يحتوي على جميع خاصِّيَّات CSS التي يمكن استعمالها دون واحدة. يستعمل التابع .css() هذا الكائن ليتحقَّق إن كان بإمكانه إضافة الواحدة px إلى القيم المعطاة دون واحدة.
jQuery.error()
يأخذ هذا التابع قيمةً ثمَّ يرمي استثناءً يحتوي على هذه القيمة.
jQuery.escapeSelector()
يهرِّب هذا التابع مجموعةً من المحارف التي تشبه اسم محدِّد في CSS.
jQuery.extend()
يدمج هذا التابع محتويات عنصرين أو أكثر مع بعضهما بعضًا ويضع الناتج في الكائن الأول.
jQuery.noConflict()
يجبر هذا التابع jQuery على التنازل عن التحكم بالمتغيِّر $.
jQuery.ready()
هذه الخاصية هي كائنٌ شبيه بالكائن Pormise (يدعى Thenable) التي تستبين عن اللحظة الزمنيَّة التي يصبح فيها المستند جاهزًا.
jQuery.readyException()
يعالج هذا التابع الأخطاء التي رميت في الدوال المُغلَّفَة في jQuery() بشكل متزامن.
jQuery.sub()
ينشئ هذا التابع نسخةً جديدةً من jQuery للتمكن من تعديل خاصِّيَّاتها وتوابعها دون المساس بالمكتبة الأصليَّة.
jQuery.when()
يوفِّر هذا التابع طريقةً لتنفيذ دوال ردود النداء بناءً على حالة الكائنات Thenable الممرَّرة إليها (من الممكن أن لا يمرَّر أيُّ كائن أيضًا)، ويمرَّر عادةً كائنات من النوع Deferred عوضًا عنها التي تمثل أحداثًا غير متزامنة.
.pushStack()
يضيف هذا التابع مجموعة من عناصر DOM إلى مُكدِّس jQuery.
المحددات
توفر مكتبة jQuery مجموعة قوية من الأدوات لمطابقة العناصر وتحديدها في الصفحة، إذ استفادت المكتبة من CSS بجميع إصداراتها.
من أجل استعمال المحارف الخاصة (مثل !"#$%&'()*+,./:;<=>?@[\]^`{|}~
) كجزء صرف من الاسم المراد تحديده، يجب أن تهرب تلك المحارف عبر \\. على سبيل المثال، إن كان اسم العنصر المراد تحديده هو id="foo.bar"، يمكنك تحديده عبر المُحدِّد $("#foo\\.bar"). تحوي مواصفات CSS القياسية (أي W3C CSS specification) مجموعة كاملة من القواعد المتعلقة بالمحددات الصالحة. هنالك أيضًا مقالة مفيدة لصاحبها Mathias Bynens تتحدث عن تهريب سلسلة من الحارف في CSS.
محدد جميع العناصر
يُحدِّد جميع العناصر.
المحدد :animated
يُحدِّد جميع العناصر قيد التحريك حاليًّا في وقت تشغيل المُحدِّد.
محدد الخاصيات ذات السابقة [name|="value"]
يُحدِّد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تساوي السلسلة النصيّة المُعطاة أو تبدأ بتلك السلسلة النصيّة متبوعةً بشرطة (-
).
محدد الخاصيات التي فيها [name*="value"]
يُحدِّد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تحتوي على السلسلة النصيّة الفرعيّة المُعطاة.
محدد الخاصيات التي فيها كلمة [name~="value"]
يُحدِّد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تحتوي على الكلمة المُعطاة محدودةً بينها بمسافات فارغة.
محدد الخاصيات التي تنتهي بـ [name$="value"]
يُحدِّد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تنتهي بالضّبط بالسلسلة النصيّة المُعطاة.
محدد الخاصيات التي تساوي [name="value"]
يُحدِّد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تُساوي تمامًا قيمة مُعيَّنة.
محدد الخاصيات التي لا تساوي [name!="value"]
يُحدِّد العناصر التي إمّا لا تمتلك خاصيّة HTML المُحدَّدة أو تمتلكها ولكن قيمتها لا تُساوي القيمة المُعيَّنة.
محدد الخاصيات التي تبدأ بـ [name^="value"]
يُحدِّد العناصر التي تمتلك خاصيّة HTML المُحدَّدة والتي قيمتها تبدأ بالضّبط بالسلسلة النصيّة المُعطاة.
المحدد :button
يُحدِّد عناصر الأزرار <button>
والعناصر التي من نوع button
.
المحدد :checkbox
يُحدِّد جميع العناصر ذات النوع مربّع تأشير (checkbox).
المحدد :checked
يُستخدَم لمعرفة العناصر المُؤشَّرة (checked) أو المُحدَّدة (selected).
محدد العناصر الأبناء "parent > child"
يُحدِّد كافّة العناصر الأبناء المباشرة والتي هي أبناء العناصر المُحدَّدة بأب (parent).
محدد الأصناف ".class"
يُحدِّد كافّة العناصر التي تمتلك الصّنف المُعطَى.
المحدد :contains()
يُحدِّد كافّة العناصر التي تحتوي على النص المطلوب.
محدد العناصر السليلة "ancestor descendant"
تحديد جميع العناصر التي تنتمي إلى سلف معين.
المحدد :disabled
تحديد جميع العناصر المعطلة.
محدد العناصر "element"
يُحدد جميع العناصر التي تحمل اسم الوسم المُعطى.
المحدد :empty
يُزيل هذا التابع كافة العُقَد السليلة لمجموعة العناصر المتطابقة من DOM.
المحدد :enabled
يحدد كل العناصر المُفعَّلة (enabled).
المحدد :eq()
يُحدد العنصر الموجود في الفهرس n
داخل المجموعة المتطابقة.
المحدد :even
يختار هذا المحدد العناصر الزوجية، وهو مُحدد صفري مفهرس. انظر أيضا المحدد :odd
.
المحدد :file
يحدد كل حقول الإدخال من النوع file التي تسمح برفع الملفات.
المحدد :first-child
يحدد كل العناصر التي تكون أول ابن للعنصر الأب الذي تتبع له.
المحدد :first-of-type
يحدد كل العناصر التي تكون الأولى بين العناصر الأخوة المجاورة لها ولها نفس اسم العنصر.
المحدد :first
يحدد أول عنصر DOM متطابق.
المحدد :focus
يحدد العنصر إذا كان مُركّزًا عليه حاليًا.
المحدد :gt()
يحدِّد كل العناصر التي لها فهرس (index) أكبر من المعامل index المعطى داخل المجموعة المطابقة.
محدد العناصر التي لها الخاصية [name]
يختار هذا المحدد العناصر التي تمتلك خاصية معينة مهما كانت قيمتها.
المحدد :has()
يختار هذا المحدد العناصر التي تحتوي على عنصر واحد على الأقل والذي تطابق مع المُحدِّد المُمرَّر.
المحدد :header
يختار هذا المحدد كل عناصر الترويسات مثل الترويسة h1 والترويسة h2 والترويسة h3 ...إلخ.
يختار هذا المحدد كل العناصر المخفية.
محدد المعرفات "#id"
يختار هذا المحدد العنصر الذي يمتلك المعرف id المعطى.
المحدد :image
يختار هذا المحدد كل العناصر ذات النوع image.
المحدد :input
يحدد هذا المحدد كل العناصر التي من النوع <input>
، و <textarea>
، و <select>
، و <button>
.
المحدد :lang()
يحدِّد جميع العناصر التي تشترك بلغة معيَّنة.
المحدد :last-child
يحدِّد جميع العناصر التي تُعدُّ الابن الأخير لآبائها.
المحدد :last-of-type
يحدِّد جميع العناصر التي يُعدُّ كل واحد منها العنصر الأخير بين أخوته التي لها الاسم ذاته.
المحدد :last
يحدِّد العنصر الأخير المتطابق.
المحدد :lt()
يحدِّد جميع العناصر التي فهرسها أقل من القيمة index المعطاة في المجموعة المطابقة.
محدد أكثر من خاصية [name="value"][name2="value2"]
يحدِّد العناصر التي تطابق جميع مرشِّحات خاصِّيَّة معينة.
محدد أكثر من عنصر "selector1, selector2, selectorN"
يحدِّد نتائج جميع المحددات المعطاة.
محدد العناصر الأخوة المتجاورة "prev + next"
يحدِّد جميع العناصر التالية التي تطابق "next"، ويسبقها العناصر الأخوة "prev" مباشرةً.
محدد العناصر الأخوة "prev ~ siblings"
يحدِّد جميع العناصر الأخوة التي يسبقها العنصر "prev"، وتشترك معه بالعنصر الأب نفسه، وتطابق محدِّد الترشيح "siblings".
المحدد :not()
يحدِّد جميع العناصر التي لا تطابق المحدِّد المعطى.
المحدد :nth-child()
يحدِّد عناصرًا ذات موقع محدَّد ضمن مجموعة من العناصر الأخوة (أي جميعها أبناء لعناصر أخرى).
المحدد :nth-last-child()
يحدِّد عناصرًا ذات موقع محدَّد ضمن مجموعة من العناصر الأخوة (أي جميعها أبناء لعناصر أخرى) وذلك بدءًا من نهاية المجموعة وحتى بدايتها.
المحدد :nth-last-of-type()
يحدِّد عناصرًا ذات موقع محدَّد ضمن مجموعة من العناصر الأخوة (أي جميعها أبناء لعناصر أخرى) التي لها اسم العنصر ذاته وذلك بدءًا من نهاية المجموعة وحتى بدايتها.
المحدد :nth-of-type()
يحدِّد عناصر ذات موقع محدد ضمن مجموعة من العناصر الأخوة (أي جميعها أبناء لعناصر أخرى) التي لها اسم العنصر ذاته.
المحدد :odd
يحدِّد جميع العناصر التي قيمة فهرسها فرديَّة، إذ تستعمل فهرسًا صفريًّا (zero-indexed). انظر أيضًا المحدِّد :even.
المحدد :only-child
يحدِّد جميع العناصر التي تكون ابنًا وحيدًا للعنصر الأب (أي العنصر الذي ليس لديه أية عناصر إخوة).
المحدد :only-of-type
يحدِّد جميع العناصر التي تكون ابنًا وحيدًا للعنصر الأب (أي العنصر الذي ليس لديه أية عناصر إخوة) وتملك اسم ذلك العنصر نفسه.
المحدد :parent
يختار هذا المحدِّد جميع العناصر التي لها ابن واحد على الأقل (بما في ذلك العقد النصية).
المحدد :password
يحدِّد جميع عناصر الإدخال ذات النوع "password".
المحدد :radio
يحدِّد جميع عناصر الإدخال <input>
ذات النوع radio.
المحدد :reset
يحدِّد جميع عناصر الإدخال <input>
ذات النوع reset.
المحدد :root
يحدِّد العنصر الجذر في شجرة المستند.
المحدد :selected
يحدِّد جميع العناصر المُحدَّدة.
المحدد :submit
يحدِّد جميع عناصر الإدخال <input>
ذات النوع "submit".
المحدد :target
يحدِّد عنصرًا فريدًا يُطابِق مُعرِّفه id معرِّف قطعةٍ من رابط URL للصفحة.
المحدد :text
يحدِّد جميع عناصر الإدخال <input>
ذات النوع "text".
المحدد :visible
تحديد كل العناصر المرئية.
التنقل بين العناصر
تتيح التوابع في هذا القسم بتحديد عناصر موجودة في موضع محدد والتنقل بينها.
.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()
يقلِّص هذا التابع مجموعة العناصر المطابقة إلى مجموعة فرعيَّة موجودة في مجال محدَّد.
تعديل العناصر
جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل عنصر بأكمله (أو مجموعة من العناصر) وبذاته مثل الإضافة، أو النسخ، أو الحذف، أو الإزالة ...إلخ. (إن كنت تبحث عن توابع تعدل خاصية عنصر، فانتقل إلى قسم «تعديل الخاصيات»).
.after()
يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل بعد كل عنصر من مجموعة العناصر المُطابقة.
.append()
يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل إلى آخر كل عنصر من مجموعة العناصر المُطابِقة.
.appendTo()
يُدخِل هذا التّابع كل عنصر من مجموعة العناصر المُطابِقة إلى نهاية العنصر الهدف.
.before()
يُدخِل هذا التّابع المحتوى المُحدَّد عن طريق المُعامِل قبل كل عنصر من مجموعة العناصر المُطابقة.
.clone()
يُنشِئ هذا التّابع نسخة عميقة (deep copy) من مجموعة العناصر المُطابِقة.
.css()
يحصل هذا التّابع على قيمة خاصيّة تنسيق محسوبة (computed style property) للعنصر الأول من مجموعة العناصر المُطابِقة أو يُعيِّن واحدة أو أكثر من خاصيّات CSS لكل عنصر مُطابِق.
.detach()
حذف مجموعة العناصر المتطابقة من DOM.
.empty()
يُحدد جميع العناصر التي ليس لها أبناء (بما في ذلك العُقَد النصية).
.insertAfter()
إدخال كل عنصر من مجموعة العناصر المُطابقة بعد الهدف.
.insertBefore()
إدخال كل عنصر من مجموعة العناصر المُطابقة بعد الهدف.
jQuery.htmlPrefilter()
يعدِّل ويرشِّح هذا التابع سلاسل HTML النصية الممرَّرة عبر توابع التعديل (manipulation) في jQuery.
.prepend()
يُستخدَم هذا التابع في إدخال لمحتوى المُحدَّد عن طريق المُعامِل إلى بداية كل عنصر من مجموعة العناصر المُطابِقة.
.prependTo()
يُستخدَم هذا التابع في إدخال كل عنصر من مجموعة العناصر المُطابِقة إلى بداية العنصر الهدف.
.remove()
يحذف هذا التابع مجموعة العناصر المطابقة من DOM.
.removeAttr()
يحذف هذا التابع خاصِّيَّة HTML محدَّدة لكل عنصر في مجموعة العناصر المطابقة.
.removeClass()
يحذف هذا التابع صنفًا واحدًا، أو عدَّة أصناف، أو جميع الأصناف من كل عنصر في مجموعة العناصر المطابقة.
.removeProp()
يحذف هذا التابع خاصِّيَّة كائنيِّة محدَّدة لكل عنصر في مجموعة العناصر المطابقة.
.replaceAll()
يبدِّل هذا التابع مجموعة العناصر المطابقة مكان كل عنصر من العناصر المحدَّدة.
.replaceWith()
يبدِّل هذا التابع المحتوى الجديد المعطى مكان كل عنصر في مجموعة العناصر المطابقة، ويعيد مجموعة العناصر التي استُبدلت.
.text()
يجلب هذا التابع المحتوى النصي المرتبط بكل عنصر في مجموعة العناصر المطابقة بالإضافة إلى العناصر الأحفاد لهم، أو يغيِّر المحتوى النصي للعناصر المطابقة.
.toggleClass()
إضافة أو إزالة صنف واحد أو أكثر من كل عنصر من مجموعة العناصر المُطابقة، اعتمادًا على وجود الصنف أو قيمة وسيط الحالة.
.unwrap()
إزالة آباء مجموعة العناصر المُطابقة من شجرة DOM، مع ترك العناصر المُطابقة في مكانها.
.wrap()
تغليف شيفرة HTML حول كل عنصر في مجموعة العناصر المُطابقة.
.wrapAll()
تغليف شيفرة HTML حول جميع العناصر في مجموعة من العناصر المُطابقة.
.wrapInner()
تغليف شيفرة HTML حول محتوى كل عنصر في مجموعة العناصر المُطابقة.
تعديل الخاصيات
جميع التوابع في هذا القسم تعدل وتتلاعب بشجرة DOM عبر تعديل خاصية محددة لعنصر (أو مجموعة من العناصر). توصف أغلبية هذه التوابع على أنها «توابع ضابطة» (setters)، إذ تضبط وتغير قيمة خاصية محددة. هنالك قلة من هذه التوابع توصف على أنها «توابع جالبة» (getters) مثل .attr()
و .html()
و .val()
لأنها تجلب معلومات من عناصر DOM لاستخدامها لاحقًا. (إن كنت تود إجراء تعديل على العنصر نفسه، فارجع إلى قسم «تعديل العناصر»).
.addClass()
يُضيف هذا التّابع الصّنف أو الأصناف المُحدَّدة لكل عنصر من مجموعة العناصر المُطابقة.
.attr()
يحصل هذا التّابع على قيمة خاصيّة HTML لأوّل عنصر من مجموعة العناصر المُطابِقة، أو يُعيِّن خاصيّة HTML أو عدة خاصيّات لكل عنصر مُطابِق.
.hasClass()
يحدد هذا التابع إن كانت العناصر التي اختيرت سابقًا تمتلك صنفًا معينًا أم لا.
.html()
يجلب هذا التابع محتوى HTML لأول عنصر في مجموعة العناصر المطابقة أو يغير محتوى HTML لكل العناصر المطابقة.
.prop()
يجلب هذا التابع قيمة خاصِّيَّة كائن محدَّدةٍ للعنصر الأول من مجموعة العناصر المطابقة.
.val()
إعادة القيمة الحالية للعنصر الأول في مجموعة العناصر المُطابقة أو تعيين قيمة (value) كل عنصر مُطابق.
التأثيرات والحركات
.animate()
يُنفِّذ هذا التّابع تحريكًا (animation) لخاصيّة أو لمجموعة من خاصيّات CSS.
.clearQueue()
يُزيل هذا التّابع كافّة العناصر التي لم تُشغَّل حتى الآن من الطابور.
.delay()
يضبط هذا التابع مؤقِّت لتأجيل تنفيذ العناصر التالية في طابور (queue) الانتظار.
.fadeIn()
يعرض هذا التابع العناصر المطابقة عن طريق تحويلها إلى الإعتام (opaque، أي لن تصبح شفافةً) تدريجيًا.
.fadeOut()
يُخفي هذا التابع العناصر المطابقة عن طريق تحويلها إلى شفافة تدريجيًا.
.fadeTo()
يضبط هذا التابع درجة عتامة العناصر المطابقة.
.fadeToggle()
يعرض هذا التابع العناصر المطابقة أو يخفيها عن طريق تحريك درجة العتامة.
.dequeue()
.finish()
ينهي هذا التابع الحركة الجاري تشغيلها، ويُزيل كل الحركات المدرجة في طابور الانتظار، ويكمل جميع حركات العناصر المطابقة.
.hide()
يخفي هذا التابع كل العناصر المتطابقة.
jQuery.fx.interval()
تمثِّل قيمة هذه الخاصِّيَّة الفترة الزمنية (بالميلي ثانية) التي ستنفَّذ الحركات في أثنائها.
jQuery.fx.off()
تعمل هذه الخاصِّيَّة على تعطيل جميع الحركات على الصعيد العام.
jQuery.speed()
ينشئ هذا التابع كائنًا يحتوي على مجموعةٍ من الخاصِّيَّات الجاهزة لاستعمالها في تعريف حركات مخصَّصة.
.queue()
يجلب هذا التابع طابور الدوال المطلوب تنفيذها على العناصر المطابقة.
.show()
يُظهِر هذا التابع جميع العناصر المطابقة.
.slideDown()
يُظهِر هذا التابع جميع العناصر المتطابقة مع حركة انسحابيَّة.
.slideToggle()
يُظهِر هذا التابع أو يخفي جميع العناصر المطابقة مع حركة انسحابيَّة.
.slideUp()
يخفي هذا التابع جميع العناصر المطابقة مع حركة انسحابيَّة.
.stop()
يوقف هذا التابع الحركة التي يجري تنفيذها آنذاك على العناصر المطابقة.
.toggle()
يبدِّل هذا التابع حالة العناصر المُطابقة بين العرض و الإخفاء.
الأحداث
.bind()
يُرفِق هذا التّابع مُعالِج أحداث (Event handler) لحدثٍ ما للعناصر.
.blur()
يربط هذا التّابع مُعالِج أحداث (event handler) إلى حدث الضّبابيّة (blur) في JavaScript، أو يُطلِق هذا الحدث على عنصر ما.
.change()
يربط هذا التّابع مُعالِج الأحداث (event handler) لتغيير حدث JavaScript أو يُطلِق هذا الحدث على عنصر ما.
.click()
يربط هذا التّابع مُعالِج الأحداث (event handler) إلى الحدث click
في JavaScript أو يُطلِق هذا الحدث على عنصر ما.
يربط هذا التّابع مُعالِج أحداث (event handler) إلى الحدث contextmenu
في JavaScript، أو يُطلِق هذا الحدث على عنصر ما.
.dblclick()
يربط هذا التابع معالج حدث بحدث "dblclick
" من JavaScript، أو يُطلق هذا الحدث على عنصرٍ ما.
.delegate()
إرفاق معالج بأحد الأحداث أو أكثر لكافة العناصر التي تطابق المُحدِد، الآن أو في المستقبل، استنادًا إلى مجموعة محددة من عناصر الجذر.
.error()
ربط معالج الحدث بحدث الخطأ "error" في JavaScript.
=event.currentTarget
عنصر DOM الحالي خلال مرحلة إنتاج فقاعات الحدث.
event.data
كائن اختياري يحتوي على بيانات الحدث، يُمرر إلى دالة معالجة الحدث.
event.delegateTarget
العنصر المُرفق به معالج أحداث jQuery المُستدعى حاليًا.
event.isDefaultPrevented()
يتحقق هذا التابع من استدعاء الحدث event.preventDefault()
على كائن الحدث هذا.
event.isImmediatePropagationStopped()
تتحقق هذه الخاصية من استدعاء الحدث event.stopImmediatePropagation()
على كائن الحدث هذا.
event.isPropagationStopped()
نتحقق هذه الخاصية من استدعاء الحدث event.stopPropagation()
على كائن الحدث هذا.
event.metaKey
تشير هذه الخاصية إذا ما كان مفتاح META مضغوطًا عند إطلاق الحدث.
event.namespace
تعيد هذه الخاصية مجال الأسماء (namespace) المستخدم عند إطلاق الحدث.
event.pageX
تُعيد هذه الخاصية موضع الفأرة بالنسبة إلى الحافة اليسرى للمستند.
event.pageY
تُعيد هذه الخاصية موضع الفأرة بالنسبة إلى الحافة العلوية للمستند.
event.preventDefault()
استدعاء هذه الخاصية يُعطل إطلاق الإجراء الافتراضي للحدث.
عنصر DOM الآخر المتضمن في الحدث، إن وجد.
event.result
تعيد هذه الخاصية القيمة الأخيرة المُعادة بواسطة معالج الأحداث الذي أطلقه هذا الحدث، ما لم تكن هذه القيمة غير معرفة undefined
.
event.stopImmediatePropagation()
تمنع هذه الخاصية تنفيذ بقية معالجات الأحداث ومنع الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling).
event.stopPropagation()
يمنع هذا التابع الحدث من الانتقال عبر شجرة DOM إلى العناصر الأب (event bubbling)، مما يمنع إبلاغ أي من المعالجات الأب عن الحدث.
event.target
تعيد هذه الخاصية عنصر DOM الذي بدأ الحدث.
event.timeStamp
فرق الوقت محسوب بالميللي ثانية بين وقت إنشاء المتصفح للحدث وليلة رأس سنة 1970.
event.type
تصف هذه الخاصية طبيعة الحدث.
event.which
لكل حدث يتولد من لوحة المفاتيح أو الفأرة، تشير هذه الخاصية إلى المفتاح أو الزر المحدد المضغوط عليه.
.focus()
ربط دالة معالج أحداث بحدث "focus"
من JavaScript، أو إطلاق هذا الحدث على عنصر.
.focusin()
يربط هذا التابع دالة معالج الحدث بحدث "focusin"
من JavaScript.
.focusout()
يربط هذا التابع دالة معالج الحدث بحدث "focusout"
من JavaScript.
.hover()
يربط هذا التابع معالجًا واحدًا أو معالجين بالعناصر المطابقة لتُنفَّذ عندما يدخل ويخرج مؤشر الفأرة من حيز العناصر.
jQuery.holdReady()
يعلِّق هذا التابع تنفيذ الحدث ready في jQuery أو يحرِّره إن كان معلَّقًا.
jQuery.queue()
يعرض هذا التابع طابور الدوال المراد تنفيذها على العنصر المطابق.
.keydown()
يربط هذا التابع معالج حدث معين مع الحدث keydown (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.keypress()
يربط هذا التابع معالج حدث معين مع الحدث keypress (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.keyup()
يربط هذا التابع معالج حدث معين مع الحدث keyup (الضغط على مفتاح في لوحة المفاتيح) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.live()
يربط هذا التابع معالج حدث معين بجميع العناصر التي طابقت المحدِّد الحالي الآن وفي المستقبل.
.mousedown()
يربط هذا التابع معالج حدث معين مع الحدث mousedown (الضغط على زر الفأرة) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.mouseenter()
يربط هذا التابع معالج حدث معين مع الحدث mouseenter عندما يدخل مؤشِّر الفأرة حيِّز عنصر، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.mouseleave()
يربط هذا التابع معالج حدث معين مع الحدث mouseleave عندما يخرج مؤشِّر الفأرة من حيِّز عنصرٍ، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.mousemove()
يربط هذا التابع معالج حدث معين مع الحدث mousemove (التحرك داخل العنصر) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.mouseout()
يربط هذا التابع معالج حدث معين مع الحدث mouseout (الخروج من حيِّز عنصر) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.mouseover()
يربط هذا التابع معالج حدث معين مع الحدث mouseover (الدخول حيِّز عنصر) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.mouseup()
يربط هذا التابع معالج حدث معين مع الحدث mouseup (تحرير زر الفأرة المضغوط) في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.off()
يزيل هذا التابع معالج حدث معين.
.on()
يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر بالعناصر المحدَّدة.
.one()
يربط هذا التابع دالة معالج حدث لحدثٍ واحدٍ أو أكثر بالعناصر المحدَّدة. يُنفَّذ معالج الحدث مرةً واحدةً لكل عنصر ولكل نوع من الأحداث المرتبطة.
.ready()
ينفِّذ هذا التابع دالةً عندما تكون شجرة DOM جاهزة.
.resize()
يربط هذا التابع معالج حدث معين مع الحدث resize في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.scroll()
يربط هذا التابع معالج حدث معين مع الحدث scroll في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.select()
يربط هذا التابع معالج حدث معين مع الحدث select في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.submit()
يربط هذا التابع معالج حدث معيَّن مع الحدث submit في JavaScript، أو يستدعي ذلك الحدث لتطبيقه على عنصر.
.toggle_event()
ربط معالجين أو أكثر بالعناصر المتطابقة، لتنفيذها بالتناوب.
.trigger()
تنفيذ جميع المعالجات والسلوكيات المرفقة بالعناصر المطابقة لنوع الحدث المُدخَل.
.triggerHandler()
تنفيذ كافة معالجات الأحداث التي تتعلق على عنصرٍ لحدث.
.unbind()
إزالة معالج أحداث سبق إرفاقه بالعناصر.
.undelegate()
إزالة معالج من الحدث لكافة العناصر التي تطابق المُحدِّد الحالي، استنادًا إلى مجموعة محددة من عناصر الجذر.
.unload()
ربط أحد معالجات الأحداث بحدث unload
في JavaScript.
التعامل مع البيانات
.data()
يخزِّن التابع .data()
بيانات عشوائية مرتبطة بالعناصر المتطابقة أو تُعيد القيمة في مخزن البيانات المحدد للعنصر الأول في مجموعة العناصر المتطابقة.
jQuery.data()
يخزِّن هذا التابع بيانات اعتباطيَّة ويقرنها بعنصر محدَّد، ويعيد القيمة التي ضُبِطَت.
jQuery.hasData()
يتحقَّق هذا التابع إن كان يملك عنصرٌ محدَّدٌ أيَّةَ بياناتٍ مرتبطةٍ به.
jQuery.proxy()
يأخذ هذا التابع دالةً ويعيد أخرى جديدة تحوي محتوًى محددًّا.
jQuery.removeData()
يحذف هذا التابع جزءًا من البيانات المُخزَّنة مسبقًا والمرفقة بعنصر محدَّد.
.removeData()
يحذف هذا التابع جزءًا من البيانات المخزَّنة مسبقًا.
خدمات jQuery
jQuery.dequeue()
ينفَّذ هذا التابع الدالة التالية الموجودة في طابور الانتظار للعناصر المتطابقة.
jQuery.each()
هذه الدالة هي دالة تكرار عامة تستعمل لتكرار تنفيذ دالة بسلاسة تامة عبر الكائنات والمصفوفات. عدد مرات تكرار تنفيذ الدالة على المصفوفات والكائنات الشبيهة بالمصفوفات التي لها الخاصِّيَّة length (مثل الكائن الذي يحوي وسائط دالةٍ) تنحصر بالمجال من 0 إلى length-1، إذ length هو عدد العناصر. أمَّا عدد مرات تكرار الكائنات الأخرى تتعلق بالخصائص المسماة للكائن.
jQuery.fn.extend()
يدمج هذا التابع محتويات كائنٍ مع الكائن prototype في jQuery لتوفير نسخةٍ جديدةٍ من توابع jQuery.
jQuery.globalEval()
يُنفِّذ هذا التابع جزءًا من شيفرة JavaScript على الصعيد العام.
jQuery.grep()
يبحث هذا التابع عن عناصر مصفوفة تتطابق مع الدالة المرشِّحة المعطاة ثمَّ يعيد هذه العناصر بطريقة لا تتأثر فيها المصفوفة الأصليَّة.
jQuery.inArray()
يبحث هذا التابع عن قيمة محدَّدة ضمن مصفوفةٍ ثمَّ يعيد قيمة فهرس موضعها (أو القيمة -1 إن لم يجدها).
jQuery.isArray()
يتحقَّق هذا التابع إن كان الوسيط الممرَّر إليه مصفوفةً أم لا.
jQuery.isEmptyObject()
يتحقَّق هذا التابع إن كان الكائن المُمرَّر إليه فارغًا (لا يحوي أيَّة خاصِّيَّة قابلة للإحصاء) أم لا.
jQuery.isFunction()
يتحقَّق هذا التابع إن كان الكائن الممرَّر إليه دالةَ ردِّ نداءٍ أم لا.
jQuery.isNumeric()
يتحقَّق هذا التابع إن كان الكائن الممرَّر إليه عددًا (Number) أم لا.
jQuery.isPlainObject()
يتحقَّق هذا التابع إن كان الكائن الممرَّر إليه كائنًا مجرَّدًا (أُنشئ باستعمال "{}
" أو "new Object
") أم لا.
jQuery.isWindow()
يتحقَّق هذا التابع إن كان الوسيط الممرَّر إليه هو الكائن window أم لا.
jQuery.isXMLDoc()
يتحقَّق هذا التابع إن كانت عقدة DOM المُمرَّر إليه ضمن مستند XML (أو هل هو مستند XML) أم لا.
jQuery.makeArray()
يحوِّل هذا التابع كائنًا شبيهًا بمصفوفة إلى مصفوفة JavaScript حقيقية.
jQuery.map()
يُمرِّر هذا التابع كلَّ عنصر من عناصر مصفوفة أو كائن إلى دالةٍ، ثمَّ ينشئ مصفوفةً جديدةً تحتوي على القيم المعادة.
jQuery.merge()
تدمج هذه الدالة محتوى مصفوفتين مع بعضهما بعضًا وتضع الناتج في المصفوفة الأولى.
jQuery.noop()
هذه الدالة هي دالةٌ فارغةٌ.
jQuery.now()
يعيد هذا التابع عددًا يمثِّل الوقت الحالي.
jQuery.parseHTML()
يفسِّر هذا التابع سلسلة نصية تحتوي على شيفرة HTML ثمَّ يعيد مصفوفة من عقد DOM.
jQuery.parseJSON()
يعيد مصفوفةً (Array) أو سلسلةً نصيةً (String) أو عددًا (Number) أو كائنًا (Object) أو قيمة منطقيَّة (Boolean).
jQuery.parseXML()
يفسِّر هذا التابع سلسلة نصية بصيغة XML إلى مستند XML.
jQuery.trim()
يزيل هذا التابع جميع المسافات البيضاء (whitespace) من بداية ونهاية السلسلة النصية المُمرَّرة إليه.
jQuery.type()
يعيد هذا التابع نوع JavaScript الداخلي للكائن المُمرَّر إليه.
jQuery.unique()
يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط.
jQuery.uniqueSort()
يرتِّب هذا التابع مصفوفةً من عناصر DOM، في مكانها، مع حذف العناصر المتكرِّرة. انتبه إلى أنَّ هذا التابع لا يصلح للعمل إلا مع المصفوفات التي تحوي عناصر DOM فقط.
التعامل مع CSS
.height()
يجلب هذا التابع الطول الحالي لأول عنصر في مجموعة العناصر المتطابقة أو يغير الطول لكل العناصر المتطابقة.
.innerHeight()
يعيد هذا التابع قيمة الطول الحالي (تتضمن قيمة الحواشي فقط دون الإطار) لأول عنصر في مجموعة العناصر المطابقة أو يغير الطول الداخلي لكل العناصر المطابقة.
.innerWidth()
يعيد هذا التابع قيمة العرض الحالي (تدخل قيمة الحواشي ضمنها فقط) لأول عنصر من مجموعة العناصر المطابقة أو يغير العرض الداخلي لكل العناصر المطابقة.
jQuery.cssHooks()
يتعلَّق هذا التابع بـ jQuery مباشرةً للتحكم بكيفيَّة استعادة أو ضبط قيم خاصِّيَّات CSS محدَّدة، أو توحيد أسماء خاصِّيَّات CSS، أو إنشاء خاصِّيَّات CSS مخصَّصة.
jQuery.cssNumber()
يعيد هذا التابع كائنًا يحتوي على جميع خاصِّيَّات CSS التي يمكن استعمالها دون واحدة. يستعمل التابع .css() هذا الكائن ليتحقَّق إن كان بإمكانه إضافة الواحدة px إلى القيم المعطاة دون واحدة.
jQuery.escapeSelector()
يهرِّب هذا التابع مجموعةً من المحارف التي تشبه اسم محدِّد في CSS.
.offset()
يجلب هذا التابع الإحداثيات الحاليَّة للعنصر الأول في مجموعة العناصر المطابقة نسبةً إلى الصفحة.
.outerHeight()
يجلب هذا التابع قيمة الارتفاع الخارجي (outer height، تتضمن الحواشي [padding]، والإطار [border]، والهامش [margin] اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة، أو يغير قيمة الارتفاع الخارجي لكل العناصر المطابقة.
.outerWidth()
يجلب هذا التابع قيمة العرض الخارجي (outer width، تتضمن الحواشي [padding]، وحدَّ الإطار [border]، والهامش [margin] اختياريًّا) الحاليَّة لأول عنصر في مجموعة العناصر المطابقة، أو يغير قيمة العرض الخارجي لكل العناصر المطابقة.
.position()
يجلب هذا التابع الإحداثيات الحالية للعنصر الأول في المجموعة المطابقة نسبةً إلى أقرب عنصر أب متموضع (offset parent) لذلك العنصر.
.scrollLeft()
يجلب هذا التابع موضع شريط التمرير الأفقي الحالي للعنصر الأول من مجموعة العناصر المطابقة.
.scrollTop()
يجلب هذا التابع موضع شريط التمرير الشاقولي الحالي للعنصر الأول من مجموعة العناصر المطابقة.
.width()
إعادة العرض الحالي المحسوب للعنصر الأول من مجموعة العناصر المُطابقة، أو ضبط عرض CSS لكل عنصر في مجموعة العناصر المُطابقة.
التعامل مع Ajax
.ajaxComplete()
يُسجِّل هذا التّابع مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال طلبات Ajax.
.ajaxError()
يُسجِّل هذا التّابع مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال تنفيذ طلب Ajax مع حدوث خطأ.
.ajaxSend()
يُرفِق هذا التّابع دالة لتنفيذها قبل إرسال طلب Ajax.
.ajaxStart()
يُسجِّل هذا التّابع مُعالِج الأحداث (Event handler) لاستدعائه عند بدء أول طلب Ajax.
.ajaxStop()
يُسجِّل هذا التّابع مُعالِج الأحداث (Event handler) لاستدعائه عند اكتمال تنفيذ جميع طلبات Ajax.
.ajaxSuccess()
يُرفِق هذا التّابع دالة لتنفيذها عند اكتمال تنفيذ طلب Ajax.
jQuery.ajax()
ترسل هذه الدالة طلب (Ajax) HTTP غير متزامن.
jQuery.ajaxPrefilter()
يعالج هذا التابع إعدادات Ajax المخصَّصة أو يعدِّل إعدادات موجودة قبل أن يرسل كل طلب وقبل أن يعالج باستعمال الدالة $.ajax().
jQuery.ajaxSetup()
يعيِّن هذا التابع قيمًا افتراضيَّة لطلبات Ajax المستقبليَّة، ولا ينصح باستعماله.
jQuery.ajaxTransport()
ينشئ هذا التابع كائنًا يعالج عملية الإرسال الفعلي لبيانات Ajax.
jQuery.get()
يجلب هذا التابع بياناتٍ من الخادم باستعمال طلب HTTP عبر الطريقة GET.
jQuery.getJSON()
تجلب هذه الدالة بياناتٍ مرمَّزة بصيغة من الخادم باستعمال طلب عبر الطريقة .
jQuery.getScript()
يجلب هذا التابع ملف JavaScript من الخادم باستعمال طلب HTTP عبر الطريقة GET ثمَّ يُنفِّذه.
jQuery.param()
يرمِّز (serialize) هذا التابع محتويات مصفوفة، أو كائن مجرَّد، أو كائن jQuery ويضعها في سلسلة نصيَّة لتصبح ملائمة لاستعمالها في سلسلة الاستعلام النصية لعنوان URL أو لإرسالها في طلبات Ajax. في حال تمرير كائن jQuery، فيجب أن يحوي هذا الكائن عناصر إدخال <input> لها خاصِّيَّات بالشكل اسم/قيمة.
jQuery.post()
يجلب هذا التابع بياناتٍ من الخادم باستعمال طلب HTTP عبر الطريقة POST.
.load()
يحمِّل هذا التابع البيانات من الخادم ثمَّ يضع محتوى HTML المُعاد في العنصر المتطابق.
.serialize()
يُرمِّز هذا التابع مجموعة من عناصر النماذج ويضعها في سلسلة نصيِّة من أجل إرسالها.
.serializeArray()
يُرمِّز هذا التابع مجموعة من عناصر النماذج ويضعها في مصفوفة على شكل أسماء وقيم من أجل إرسالها.
الكائن Callbacks
callbacks.add()
يُضيف رد نداء أو مجموعة من ردود النداء إلى قائمة ردود النداء.
callbacks.disable()
يُعطِّل قائمة ردود النداء ويمنعها من فعل أي شيء آخر.
callbacks.disabled()
يُحدِّد ما إذا كانت قائمة ردود النداء مُعطَّلة.
callbacks.empty()
يُزيل كافّة ردود النداء من القائمة.
callbacks.fire()
يستدعي كافّة ردود النداء عن طريق الوسائط المُعطاة.
callbacks.fired()
يُحدِّد ما إذا كانت ردود النداء قد استُدعيَت على الأقل مرّة واحدة.
callbacks.fireWith()
يستدعي كافّة ردود النداء في القائمة عن طريق السّياق (context) والوسائط المُعطاة.
callbacks.has()
يُحدِّد ما إذا كانت قائمة ردود النداء تملك أي رد نداء مُرفَق إليها. وإن زوّدناه باسم رد نداء كوسيط فسيُحدِّد ما إذا كان موجودًا في القائمة.
callbacks.lock()
يقفل قائمة ردود النداء بحالتها الحاليّة.
callbacks.locked()
يُحدِّد ما إذا كانت قائمة ردود النداء مُقفلة.
callbacks.remove()
يُزيل رد نداء أو مجموعة ردود نداء من قائمة ردود النداء.
jQuery.Callbacks()
تعيد هذه الدالة كائنًا مُتعدِّد الأغراض يُزوِّدنا بطريقة فعَّالة لإدارة قائمة ردود النداء.
الكائن Deferred
deferred.always()
يُضيف هذا التابع معالجات تُستدعَى عند حل الكائن المؤجل Deferred أو رفضه.
deferred.catch()
يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred.
deferred.done()
يُضيف هذا التابع معالجات تستدعى عند حل الكائن المؤجل Deferred.
deferred.fail()
يُضيف هذا التابع معالجات تُستدعى عند رفض الكائن المؤجل Deferred.
deferred.notify()
يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط args
المعطاة.
deferred.notifyWith()
يستدعي هذا التابع progressCallbacks لكائن مؤجل Deferred بواسطة الوسائط args
والسياق context المعطاة.
deferred.pipe()
تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة Deferreds.
deferred.progress()
يُضيف هذا التابع معالجات تستدعى عندما ينتج الكائن المؤجل Deferred إشعارات التقدُّم.
deferred.promise()
يُعيد هذا التابع كائن Promise للكائن المؤجل Deferred.
deferred.reject()
يرفُض هذا التابع كائنًا مؤجلًا ويستدعي أي failCallbacks مع الوسيط args
المُعطى.
deferred.rejectWith()
يرفض هذا التابع كائنًا مؤجلًا Deferred ويستدعي أي failCallbacks
مع سياق context
ووسائط args
محددة.
deferred.resolve()
قبول كائن مؤجل واستدعاء أي doneCallbacks
مع الوسائط args
المُحدَدة.
deferred.resolveWith()
يقبل كائن مؤجل ويستدعي أي doneCallbacks
مع السياق context
والوسائط args
المُحدَدة.
deferred.state()
يُحدد هذا التابع الحالة الحالية لكائن مؤجل.
deferred.then()
يُضيف هذا التابع معالجات تُستدعَى عند قبول الكائن المؤجل أو رفضه أو ما زال قيد التقدم.
jQuery.Deferred()
هذه الدالة هي دالةٌ منتجة (factory function) تعيد كائن أداةٍ قابل للتسلسل (chainable utility object) يمكن استعمال مجموعة من التوابع مع هذا الكائن لتسجيل عدَّة دوال رد نداءٍ في طوابير ردود النداء (callback queues)، واستدعاء هذه الطوابير فيما بعد، ونقل حالة النجاح (success state) أو الفشل (failure state) لأي دالة متزامنة (synchronous) أو غير متزامنة (asynchronous).
.promise()
يعيد هذا التابع كائنًا من النوع promise عند انتهاء تنفيذ إجراءات ذات نوع محدَّد جميعها، سواءً كانت في الطابور (queued) أم لا، والمرتبطة بالمجموعة؛ وهذا التابع مفيد لمراقبة إكتمال تنفيذ إجراءات معينة.
غير ذلك
.each()
يكرر هذا التابع، عبر كائن jQuery، تنفيذ دالة لكل عنصر متطابق.
.get()
يعيد هذا التابع عنصرًا واحدًا من العناصر الموجودة في كائن jQuery.
.index()
يبحث هذا التابع عن عنصر معين من بين العناصر المطابقة.
.size()
يعيد هذا التابع عدد العناصر الموجودة في كائن jQuery محدَّد.
.toArray()
يضع هذا التابع جميع العناصر الموجودة في مجموعة jQuery في مصفوفة ثمَّ يعيدها.