الفرق بين المراجعتين ل"jQuery/deferred/always"
ط (استبدال النص - 'JQuery' ب'jQuery') |
|||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>deferred.always()</code> في jQuery}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>deferred.always()</code> في jQuery}}</noinclude> | ||
| − | == deferred.always( alwaysCallbacks [, alwaysCallbacks ] ) == | + | == <code>deferred.always( alwaysCallbacks [, alwaysCallbacks ] )</code> == |
| − | ==== | + | ==== القيمة المعادة ==== |
| − | تُعيد كائنًا من النوع | + | تُعيد كائنًا من النوع Deferred. |
=== الوصف === | === الوصف === | ||
| − | يُضيف هذا التابع | + | يُضيف هذا التابع دوال معالجة تُستدعَى عند قبول الكائن المؤجل Deferred أو رفضه. |
=== <code>deferred.always( alwaysCallbacks [, alwaysCallbacks ] )</code> === | === <code>deferred.always( alwaysCallbacks [, alwaysCallbacks ] )</code> === | ||
| − | أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.6/ 1.6] | + | أُضيف مع الإصدار: [http://api.jquery.com/category/version/1.6/ 1.6]. |
==== <code>alwaysCallbacks</code> ==== | ==== <code>alwaysCallbacks</code> ==== | ||
| − | هو دالة أو مصفوفة من الدوال، تُستدعى عند | + | هو دالة أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه، وهو على الشكل <code>[[JavaScript/Function|Function]]()</code>. |
==== <code>alwaysCallbacks</code> ==== | ==== <code>alwaysCallbacks</code> ==== | ||
| − | هو دالة إضافية إختيارية أو مصفوفة من الدوال، تُستدعى عند | + | هو دالة إضافية إختيارية أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه، |
| − | يمكن أن يكون هذا الوسيط إما دالة مفردة أو مجموعة من الدوال. عند | + | وهو على الشكل <code>[[JavaScript/Function|Function]]()</code>. |
| + | |||
| + | يمكن أن يكون هذا الوسيط إما دالة مفردة أو مجموعة من الدوال. عند قبول أو رفض الكائن المؤجل Deferred تُستدعى الدالة <code>alwaysCallbacks</code>. ولمّا كان التابع <code>deferred.always()</code> يُعيد الكائن المؤجل Deferred، فيمكن ربط (chain) عدة توابع أخرى من الكائن المؤجل إليه بما في ذلك توابع <code>.always()</code> إضافية. | ||
| + | |||
| + | عند قبول أو رفض الكائن المؤجل، تُستدعى دوال رد النداء (callbacks) بنفس الترتيب الذي سبق وأن أُضيفوا به، وذلك باستخدام الوسائط التي مررناها للتوابع <code>[[jQuery/deferred/resolve|resolve]]</code> أو <code>[[jQuery/deferred/reject|reject]]</code> أو <code>[[jQuery/deferred/resolveWith|resolveWith]]</code> أو <code>[[jQuery/deferred/rejectWith|rejectWith]]</code>. لمزيد من المعلومات، راجع توثيق الكائن <code>[[jQuery/deferred|Deferred]]</code>. | ||
=== ملاحظة === | === ملاحظة === | ||
| − | يتلقى التابع <code>deferred.always()</code> الوسائط التي استخدمت | + | يتلقى التابع <code>deferred.always()</code> الوسائط التي استخدمت لقبول <code>[[jQuery/deferred/resolve|.resolve()]]</code> أو رفض <code>[[jQuery/deferred/reject|.reject()]]</code> الكائن المؤجل Deferred، والتي غالبًا ما تكون مختلفة جدًا. ولهذا السبب، فمن الأفضل استخدامه فقط للإجراءات التي لا تتطلب فحص الوسائط. لكن في جميع الحالات الأخرى، استخدم المعالجين <code>[[jQuery/deferred/done|.done()]]</code> أو <code>[[jQuery/deferred/fail|.fail()]]</code> حصرًا نظرًا لأن الوسائط سيكون لها ترتيب معرّف جيدًا. |
| − | === | + | === أمثلة === |
| − | + | لمّا كان التابع <code>[[jQuery/jQuery/get|jQuery.get()]]</code> يُعيد كائن <code>jqXHR</code>، وهو مشتق من كائن مؤجل، يمكننا إرفاق رد نداء لكل من النجاح والفشل باستخدام التابع <code>deferred.always()</code>.<syntaxhighlight lang="jquery"> | |
$.get( "test.php" ).always(function() { | $.get( "test.php" ).always(function() { | ||
alert( "$.get completed with success or error callback arguments" ); | alert( "$.get completed with success or error callback arguments" ); | ||
مراجعة 05:54، 6 مايو 2018
deferred.always( alwaysCallbacks [, alwaysCallbacks ] )
القيمة المعادة
تُعيد كائنًا من النوع Deferred.
الوصف
يُضيف هذا التابع دوال معالجة تُستدعَى عند قبول الكائن المؤجل Deferred أو رفضه.
deferred.always( alwaysCallbacks [, alwaysCallbacks ] )
أُضيف مع الإصدار: 1.6.
alwaysCallbacks
هو دالة أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه، وهو على الشكل Function().
alwaysCallbacks
هو دالة إضافية إختيارية أو مصفوفة من الدوال، تُستدعى عند قبول الكائن المؤجل Deferred أو رفضه،
وهو على الشكل Function().
يمكن أن يكون هذا الوسيط إما دالة مفردة أو مجموعة من الدوال. عند قبول أو رفض الكائن المؤجل Deferred تُستدعى الدالة alwaysCallbacks. ولمّا كان التابع deferred.always() يُعيد الكائن المؤجل Deferred، فيمكن ربط (chain) عدة توابع أخرى من الكائن المؤجل إليه بما في ذلك توابع .always() إضافية.
عند قبول أو رفض الكائن المؤجل، تُستدعى دوال رد النداء (callbacks) بنفس الترتيب الذي سبق وأن أُضيفوا به، وذلك باستخدام الوسائط التي مررناها للتوابع resolve أو reject أو resolveWith أو rejectWith. لمزيد من المعلومات، راجع توثيق الكائن Deferred.
ملاحظة
يتلقى التابع deferred.always() الوسائط التي استخدمت لقبول .resolve() أو رفض .reject() الكائن المؤجل Deferred، والتي غالبًا ما تكون مختلفة جدًا. ولهذا السبب، فمن الأفضل استخدامه فقط للإجراءات التي لا تتطلب فحص الوسائط. لكن في جميع الحالات الأخرى، استخدم المعالجين .done() أو .fail() حصرًا نظرًا لأن الوسائط سيكون لها ترتيب معرّف جيدًا.
أمثلة
لمّا كان التابع jQuery.get() يُعيد كائن jqXHR، وهو مشتق من كائن مؤجل، يمكننا إرفاق رد نداء لكل من النجاح والفشل باستخدام التابع deferred.always().
$.get( "test.php" ).always(function() {
alert( "$.get completed with success or error callback arguments" );
});