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

‎.fadeToggle( [duration ] [, easing ] [, complete ] )‎

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

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

الوصف

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

‎.fadeToggle( [duration ] [, easing ] [, complete ] )‎

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

duration (القيمة الافتراضية: 400)

مدة الحركة وهو من النوع عدد Number أو سلسلة نصية String. easing (القيمة الافتراضية: swing)

سلسلة نصية من النوع String، تُشير إلى دالة التخفيف المستخدمة في عملية التحوّل.

complete

دالة على الشكل Function()‎، تُستدعى بمجرد اكتمال الحركة، وتُستدعى مرة واحدة لكل عنصر مطابق.

‎.fadeToggle( options )‎

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

options

كائن من النوع Object، يقدم مجموعة من الخيارات الإضافية لتمريرها إلى التابع.

duration (القيمة الافتراضية: 400)

مدة الحركة وهي من النوع عدد Number أو سلسلة نصية String.

easing (القيمة الافتراضية: swing)

سلسلة نصية من النوع String، تُشير إلى دالة التخفيف المستخدمة في عملية التحوّل.

queue (القيمة الافتراضية: true)

قيمة منطقية Boolean تُشير إلى ما إذا كان توضع الحركة المتحركة في قائمة انتظار التأثيرات، وهي من النوع Boolean أو String.  إذا كانت قيمتها false، فستبدأ الحركة على الفور. كذلك يمكن، بدءًا من الإصدار jQuery 1.7، أن يقبل خيار queue سلسلة نصية، وفي هذه الحالة تضاف الحركة إلى قائمة الانتظار التي تمثلها تلك السلسلة. عند استخدام اسم قائمة انتظار مخصصة لا تبدأ الحركة تلقائيًا؛ فيجب عليك استدعاء .dequeue("queuename") لبدء تشغيله.

specialEasing

كائن من النوع Object، يحتوي على واحد أو أكثر من خصائص CSS المعرفة بواسطة وسيط الخصائص ودوال التخفيف المقابلة. (أُضيف مع الإصدار: 1.4 ).

step

دالة على الشكل Function( Number now, Tween tween )، تُستدعى لكل خاصية تحريك لكل عنصر متحرك. توفر هذه الدالة فرصة لتعديل الكائن Tween لتغيير قيمة الخاصية قبل ضبطها.

progress

دالة على الشكل Function( Promise animation, Number progress, Number remainingMs )، تُستدعى بعد كل خطوة من الحركات، مرة واحدة فقط لكل عنصر متحرك بغض النظر عن عدد الخصائص المتحركة. (أُضيفت مع الإصدار: 1.8 ).

complete

دالة على الشكل Function()‎، تُستدعى مرة واحدة تو اكتمال حركة العنصر.

start

دالة على الشكل Function( Promise animation )‎، تُستدعى عند بدء حركة عنصر ما. (أُضيفت مع الإصدار: 1.8 ).

done

دالة على الشكل Function( Promise animation, Boolean jumpedToEnd )، تُستدعى عند اكتمال حركة العنصر (قبول كائن Promise الخاص بها). (أُضيفت مع الإصدار: 1.8).

fail

دالة على الشكل Function( Promise animation, Boolean jumpedToEnd )، تُستدعى عند فشل إكمال حركة العنصر (رفض الكائن Promise الخاص بها). (أُضيفت مع الإصدار: 1.8 ).

always

دالة على الشكل Function( Promise animation, Boolean jumpedToEnd )، تُستدعى عند اكتمال حركة عنصر أو توقفها دون إتمامها (إما أن يكون كائن Promise قد قُبِل أو رُفِض). (أُضيف مع الإصدار: 1.8 ).

يُحرّك التابع ‎.fadeToggle عتامة العناصر المطابقة.  عند استدعاء عنصر مرئي ، تُعيّن خاصية نمط display العنصر إلى none بمجرد بلوغ العتامة 0 ، وبالتالي لن يؤثر العنصر على تخطيط الصفحة.

عند استدعاء هذا التابع على عنصر مرئي، وبمجرد وصول العتامة إلى 0، تُضبط خاصية نمط display إلى none، بحيث لا يبقى تأثير للعنصر على تخطيط الصفحة.

تُعطى المدد بالمللي ثانية، وتشير القيم الأعلى إلى حركة أبطأ، وليس أسرع. يمكن إدخال السلاسل النصية 'fast' و 'slow' للإشارة إلى الفترات 200 و 600 ميللي ثانية، على التوالي.

Easing

تحدد السلسلةُ، التي تمثل دالة التخفيف، السرعةَ التي تتقدم بها الحركة عند نقاط مختلفة داخل التحريك. تُعد تطبيقات التخفيف الوحيدة في مكتبة jQuery هي التطبيقات الافتراضية، وتُدعى swing، والتطبيق الذي يتقدم بوتيرة ثابتة ويُدعى linear. وتتوفر المزيد من دوال التخفيف مع استخدام المُلحقات، وعلى الأخص طاقم jQuery UI .

دوال رد النداء

إذا توفرت، تنطلق دوال رد النداء بمجرد اكتمال الحركة. ويمكن أن يكون هذا مفيدًا لإدراج حركات مختلفة معا في تسلسل. لا يُرسل لدوال رد النداء أي وسائط، ولكن يُضبط الكائن this إلى عنصر DOM الذي يجري تحريكه. في حالة تحريك عناصر متعددة، من المهم ملاحظة أن دالة رد نداء تُنفذ مرة واحدة لكل عنصر مُطابق، وليس مرة واحدة للحركة ككل.

اعتبارًا من الإصدار jQuery 1.6، يمكن استخدام التابع ‎.promise()‎ بالتزامن مع التابع deferred.done()‎ لتنفيذ دالة رد نداء واحدة للحركة ككل عند اكتمال حركة جميع العناصر المطابقة (راجع أمثلة التابع ‎.promise()‎‎ ).

ملاحظات إضافية

يمكن إيقاف تشغيل كافة تأثيرات jQuery، بما في ذلك ‎.fadeToggle()‎‎‎‎، بشكل عام عن طريق ضبط jQuery.fx.off = true، والذي يضبط فعليًا المدة إلى 0.

لمزيد من المعلومات، راجع jQuery.fx.off .

أمثلة

إظهار الفقرة الأولى أو إخفاءها، مُكمِلًا الحركة خلال 600 ميللي ثانية، باستخدام التخفيف الخطي linear. إظهار الفقرة الأخيرة أو إخفاءها لمدة 200 ميللي ثانية، مع إدراج رسالة "finished" عند الانتهاء.

مصادر

صفحة المحدد ‎‎‎.fadeToggle()‎‎‎‎‎‎‎‎‎‎‎‎‎ في توثيق jQuery الرسمي.