التابع 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، يمكن ربط التوابع الأخرى للكائن المؤجل به، بما في ذلك توابع .done() الإضافية. عند حل الكائن المؤجل Deferred، تُنفَّذ doneCallbacks باستخدام الوسائط المقدمة لاستدعاءات اتوابع resolve أو resolveWith بالترتيب الذي أُضيفت به. لمزيد من المعلومات، راجع وثائق Deferred object .
أمثلة
بما أن التابع 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 functions to call when the Deferred object is resolved
function fn1() {
$( "p" ).append( " 1 " );
}
function fn2() {
$( "p" ).append( " 2 " );
}
function fn3( n ) {
$( "p" ).append( n + " 3 " + n );
}
// Create a deferred object
var dfd = $.Deferred();
// Add handlers to be called when dfd is resolved
dfd
// .done() can take any number of functions or arrays of functions
.done( [ fn1, fn2 ], fn3, [ fn2, fn1 ] )
// We can chain done methods, too
.done(function( n ) {
$( "p" ).append( n + " we're done." );
});
// Resolve the Deferred object when the button is clicked
$( "button" ).on( "click", function() {
dfd.resolve( "and" );
});
</script>
</body>
</html>