الفرق بين المراجعتين لصفحة: «jQuery/deferred/pipe»
Khaled-yassin (نقاش | مساهمات) لا ملخص تعديل |
Khaled-yassin (نقاش | مساهمات) |
||
| سطر 32: | سطر 32: | ||
=== إشعار الإيقاف === | === إشعار الإيقاف === | ||
اعتبارًا من إصدار jQuery 1.8، أُوقِف التابع <code>deferred.pipe()</code>. ويجب استخدام التابع <code>[[jQuery/deferred/then|deferred.then()]]</code>، الذي يحل | اعتبارًا من إصدار jQuery 1.8، أُوقِف التابع <code>deferred.pipe()</code>. ويجب استخدام التابع <code>[[jQuery/deferred/then|deferred.then()]]</code>، الذي يحل محله بدلاً منه. | ||
يُعيد التابع <code>deferred.pipe()</code> | يُعيد التابع <code>deferred.pipe()</code> كائن Promise جديدًا يعمل على ترشيح حالات وقيم الكائن المؤجل من خلال إحدى الدالات. ,تُرشِّح الدالتين <code>doneFilter</code> و <code>failFilter</code> حالات قبول ورفض الكائن المؤجل الأصلية وقيمه. واعتبارًا من إصدار jQuery 1.7، يقبل هذا التابع أيضًا الدالة <code>progressFilter</code> لترشيح أية دوال رد نداء للمؤجل الأصلي للتوابع <code>notify</code> أو <code>notifyWith</code>. يمكن لدوال الترشيح هذه أن تعيد قيمة جديدة لتمرر إلى دوال ردود نداء كائنات Promise المُساقة <code>done()</code> أو <code>fail()</code>، أو يمكنها إعادة كائن آخر يمكن مراقبته (Diferred، Promise، وما إلى ذلك) والذي سيمرر حالة قبول أو رفض هذا الكائن وقيمه إلى دوال ردود نداء كائنات Promise المُساقة. إذا كانت دالة الترشيح المستخدمة هي <code>null</code> أو غير محددة، فسيحل كائن Promise أو يُرفض بنفس قيم الأصل. | ||
=== أمثلة === | === أمثلة === | ||
| سطر 57: | سطر 57: | ||
alert( "Value is ( 3*6 = ) 18: " + value ); | alert( "Value is ( 3*6 = ) 18: " + value ); | ||
}); | }); | ||
</syntaxhighlight>مهام | </syntaxhighlight>مهام مُعادة كسلسلة (chain) :<syntaxhighlight lang="jquery"> | ||
var request = $.ajax( url, { dataType: "json" } ), | var request = $.ajax( url, { dataType: "json" } ), | ||
chained = request.pipe(function( data ) { | chained = request.pipe(function( data ) { | ||
| سطر 69: | سطر 69: | ||
== مصادر == | == مصادر == | ||
* [http://api.jquery.com/deferred.pipe/ صفحة التابع deferred.pipe() في توثيق jQuery الرسمي]. | * [http://api.jquery.com/deferred.pipe/ صفحة التابع deferred.pipe() في توثيق jQuery الرسمي]. | ||
[[تصنيف:jQuery]] | [[تصنيف:jQuery]] | ||
[[تصنيف:jQuery Method]] | [[تصنيف:jQuery Method]] | ||
[[تصنيف:jQuery Data]] | [[تصنيف:jQuery Data]] | ||
مراجعة 19:04، 6 مايو 2018
deferred.pipe( [doneFilter ] [, failFilter ] )
أوقِفت مع الإصدار: 1.8.
القيمة المعادة
يُعيد كائنًا من النوع Promise.
الوصف
تابع أداة يُستخدم لترشيح و/أو تقييد الكائنات المؤجلة Deferreds.
deferred.pipe ([doneFilter] [، failFilter])
أُضيف مع الإصدار: 1.6.
doneFilter
هو دالة اختيارية تُستدعى عند حل الكائن المؤجل Deferred وهو على الشكل Function().
failFilter
هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل Deferred وهو على الشكل Function().
أُضيف مع الإصدار: 1.7.
deferred.pipe ([doneFilter] [، failFilter] [، progressFilter])
doneFilter
هو دالة اختيارية تُستدعى عند حل الكائن المؤجل Deferred وهو على الشكل Function().
failFilter
هو دالة اختيارية تُستدعى عند رفض الكائن المؤجل Deferred وهو على الشكل Function().
progressFilter
هو دالة اختيارية تُستدعى عند إرسال إشعارات التقدُّم للكائن المؤجل Deferred وهو على الشكل Function().
إشعار الإيقاف
اعتبارًا من إصدار jQuery 1.8، أُوقِف التابع deferred.pipe(). ويجب استخدام التابع deferred.then()، الذي يحل محله بدلاً منه.
يُعيد التابع deferred.pipe() كائن Promise جديدًا يعمل على ترشيح حالات وقيم الكائن المؤجل من خلال إحدى الدالات. ,تُرشِّح الدالتين doneFilter و failFilter حالات قبول ورفض الكائن المؤجل الأصلية وقيمه. واعتبارًا من إصدار jQuery 1.7، يقبل هذا التابع أيضًا الدالة progressFilter لترشيح أية دوال رد نداء للمؤجل الأصلي للتوابع notify أو notifyWith. يمكن لدوال الترشيح هذه أن تعيد قيمة جديدة لتمرر إلى دوال ردود نداء كائنات Promise المُساقة done() أو fail()، أو يمكنها إعادة كائن آخر يمكن مراقبته (Diferred، Promise، وما إلى ذلك) والذي سيمرر حالة قبول أو رفض هذا الكائن وقيمه إلى دوال ردود نداء كائنات Promise المُساقة. إذا كانت دالة الترشيح المستخدمة هي null أو غير محددة، فسيحل كائن Promise أو يُرفض بنفس قيم الأصل.
أمثلة
قيمة حل الترشيح:
var defer = $.Deferred(),
filtered = defer.pipe(function( value ) {
return value * 2;
});
defer.resolve( 5 );
filtered.done(function( value ) {
alert( "Value is ( 2*5 = ) 10: " + value );
});
قيمة رفض الترشيح:
var defer = $.Deferred(),
filtered = defer.pipe( null, function( value ) {
return value * 3;
});
defer.reject( 6 );
filtered.fail(function( value ) {
alert( "Value is ( 3*6 = ) 18: " + value );
});
مهام مُعادة كسلسلة (chain) :
var request = $.ajax( url, { dataType: "json" } ),
chained = request.pipe(function( data ) {
return $.ajax( url2, { data: { user: data.userId } } );
});
chained.done(function( data ) {
// data retrieved from url2 as provided by the first request
});