التابع deferred.done() في jQuery
deferred.done( doneCallbacks [, doneCallbacks ] )
القيمة المعادة
تُعيد كائنًا من النوع Deferred.
الوصف
يُضيف هذا التابع مُعالجات تستدعى عند قبول الكائن المؤجل Deferred.
deferred.done( doneCallbacks [, doneCallbacks ] )
أُضيف مع الإصدار: 1.5.
doneCallbacks
هو دالة، أو مصفوفة دوال، تُستدعى عند قبول الكائن المؤجل Deferred، وهو دالة Function().
doneCallbacks
هو دالة اختيارية إضافية، أو مصفوفة دوال، تُستدعى عند قبول الكائن المؤجل Deferred، وهو دالة Function().
يقبل التابع deferred.done() وسيطًا واحدًا أو أكثر، وكلها يمكن أن تكون إما دالة مفردة أو مجموعة من الدوال. عندما يتم قبول الكائن المؤجل Deferred، فتستدعى doneCallbacks. تُنفذ دوال رد النداء بالترتيب الذي أُضيفَت به.
لمّا كانت deferred.done() تُعيد الكائن المؤجل Deferred، يمكن تنفيذ التوابع الأخرى للكائن المؤجل كسلسلة (chain)، بما في ذلك توابع .done() الإضافية.
عند قبول الكائن المؤجل Deferred، ستُنفَّذ doneCallbacks باستخدام الوسائط التي مررناها للتوابع resolve أو resolveWith بالترتيب الذي أُضيفت به. لمزيد من المعلومات، راجع توثيق الكائن Deferred.
أمثلة
لمّا كان التابع jQuery.get يُعيد كائن jqXHR، وهو مشتق من الكائن Deferred، يمكننا ربط رد نداء بالنجاح باستخدام التابع .done().
$.get( "test.php" ).done(function() {
alert( "$.get succeeded" );
});
سيُقبَل الكائن Deferred عند نقر المستخدم على زر، مما يؤدي إلى تشغيل عدد من دوال رد النداء:
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>deferred.done demo</title>
<script src="https://code.jquery.com/jquery-1.10.2.js"></script>
</head>
<body>
<button>Go</button>
<p>Ready...</p>
<script>
// استدعاء 3 دوال عند قبول الكائن المؤجل
function fn1() {
$( "p" ).append( " 1 " );
}
function fn2() {
$( "p" ).append( " 2 " );
}
function fn3( n ) {
$( "p" ).append( n + " 3 " + n );
}
// إحداث كائن مؤجل
var dfd = $.Deferred();
// إضافة معالجات تُستدعى عند قبول dfd
dfd
// .done () يمكن أن تتخذ أي عدد من الدوال أو مصفوفات من الدوال
.done( [ fn1, fn2 ], fn3, [ fn2, fn1 ] )
// يمكن أيضا وضع التوابع في سلسلة
.done(function( n ) {
$( "p" ).append( n + " we're done." );
});
// قبول الكائن المؤجل عند نقر الزر
$( "button" ).on( "click", function() {
dfd.resolve( "and" );
});
</script>
</body>
</html>