التابع jQuery.speed()
في 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.