التابع ‎‎jQuery.speed()‎‎ في jQuery

من موسوعة حسوب
< jQuery‏ | jQuery
اذهب إلى: تصفح، ابحث

jQuery.speed( [duration ] [, settings ] )‎

القيم المعادة

يعيد كائنًا من النوع Object.

الوصف

ينشئ هذا التابع كائنًا يحتوي على مجموعةٍ من الخاصِّيَّات الجاهزة لاستعمالها في تعريف حركات مخصَّصة.

jQuery.speed( [duration ] [, settings ] )‎

أُضيفت مع الإصدار: 1.0.

duration

عدد أو سلسلة نصية تمثِّل كمية الوقت الذي ستستغرقه عملية تحريك العنصر، وقيمته الافتراضيَّة هي 400.

settings

كائن من النوع Object، وهو مجموعة من الخيارات الإضافيَّة التي يمكن تمريرها للتابع وهي:

easing

سلسلة نصية تحدِّد دالة الانتقال السلس التي ستُسخدَم خلال الحركة. القيمة الافتراضيَّة هي swing.

complete

دالة من الشكل Function()‎ تُستدعى عندما تنتهي الحركة المطبَّقة على العنصر.

jQuery.speed( [duration ] [, easing ] [, complete ] )‎

أُضيفت مع الإصدار: 1.1.

duration

عدد أو سلسلة نصية تمثِّل كمية الوقت الذي ستستغرقه عملية تحريك العنصر، وقيمته الافتراضيَّة هي 400.

easing

سلسلة نصية تحدِّد دالة الانتقال السلس ستُسخدَم خلال الحركة. القيمة الافتراضيَّة هي swing.

complete

دالة من الشكل Function()‎ تُستدعى عندما تنتهي الحركة المطبَّقة على العنصر.

jQuery.speed( setting )‎

أُضيفت مع الإصدار: 1.1.

settings

كائن من النوع Object، وهو مجموعة من الخيارات الإضافيَّة التي يمكن تمريرها للتابع وهي:

duration

عدد أو سلسلة نصية تمثِّل كمية الوقت الذي ستستغرقه عملية تحريك العنصر، وقيمته الافتراضيَّة هي 400.

easing

سلسلة نصية تحدِّد دالة الانتقال السلس ستُسخدَم خلال الحركة. القيمة الافتراضيَّة هي swing.

complete

دالة من الشكل Function()‎ تُستدعى عندما تنتهي الحركة المطبَّقة على العنصر.

يوفِّر التابع ‎$.speed()‎ طريقةً لتعريف خاصِّيَّاتٍ مثل duration، و easing، و complete لتُستعمَل مع حركة مخصَّصة. عند استعمال هذا التابع، أنت لست بحاجة إلى التعامل مع القيم الافتراضيَّة للوسائط الأخرى الاختيارية (التي تُستعمَل في التوابع الحركيَّة الأخرى مثل ‎.slideUp()‎).

هذا التابع مفيد جدًا لمطوري الإضافات الذين ينشئون توابع حركيَّة جديدة، إذ يسهم هذا التابع بتبسيط العمل. يمكن أن تجد مثالًا لهذا التابع في النموذج الحركي للتابع ‎.addClass()‎ للإضافة jQuery UI.

مصادر