الفرق بين المراجعتين لصفحة: «jQuery/callbacks/fireWith»
Kinan-mawed (نقاش | مساهمات) لا ملخص تعديل |
Kinan-mawed (نقاش | مساهمات) لا ملخص تعديل |
||
سطر 5: | سطر 5: | ||
===الوصف=== | ===الوصف=== | ||
يُستخدَم تابع رد النداء <code>callbacks.fireWith()</code> في استدعاء كافة ردود النداء الموجودة في القائمة عن طريق السياق (context) والوسطاء المُعطاة. | يُستخدَم تابع رد النداء <code>callbacks.fireWith()</code> في استدعاء كافة ردود النداء الموجودة في القائمة عن طريق السياق (context) والوسطاء المُعطاة. | ||
=== <code>callbacks.fireWith( [context ] [, args ] )</code> === | |||
أضيفت في الإصدار: 1.7. | |||
==== <code>context</code> ==== | |||
أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل مرجعًا إلى السّياق (context) والذي في إطاره يجب أن تُطلَق ردود النداء الموجودة في القائمة. | |||
==== <code>args</code> ==== | |||
كائن مشابه للمصفوفات [[JavaScript/ArrayLikeObject|(ArrayLikeObject)]]، ويُمثِّل مصفوفة أو كائن مشابه للمصفوفات الذي سيُمرَّر إلى ردود النداء الموجودة في القائمة. إن لم يُعرَّف فلن تُمرَّر أي وسطاء للتابع. | |||
يُعيد هذا التابع كائن ردود النداء المُرفَق إليه (<code>[[JavaScript/this|this]]</code>). | |||
=== أمثلة === | |||
استخدام <code>callbacks.fireWith()</code> لإطلاق قائمة من ردود النداء مع سياق مُحدَّد ومصفوفة من الوسطاء:<syntaxhighlight lang="javascript"> | |||
// دالة تسجيل بسيطة تُضاف إلى قائمة ردود النداء | |||
var log = function( value1, value2 ) { | |||
console.log( "Received: " + value1 + "," + value2 ); | |||
}; | |||
var callbacks = $.Callbacks(); | |||
// إضافة تابع التسجيل إلى قائمة ردود النداء | |||
callbacks.add( log ); | |||
// إطلاق ردود النداء في القائمة باستخدام سياق النافذة ومصفوفة من الوسطاء | |||
callbacks.fireWith( window, [ "foo","bar" ] ); | |||
// ينتج عنه "Received: foo, bar" | |||
</syntaxhighlight> | |||
==<span>مصادر</span>== | |||
* <span> </span><span>[http://api.jquery.com/callbacks.fireWith/ صفحة تابع رد النداء callbacks.fireWith() في توثيق jQuery الرسمي].</span> | |||
[[تصنيف:jQuery]] | |||
[[تصنيف:jQuery Callbacks Object]] |
مراجعة 23:02، 21 مايو 2018
تابع رد النداء callbacks.fireWith( [context ] [, args ] )
القيمة المعادة
الوصف
يُستخدَم تابع رد النداء callbacks.fireWith()
في استدعاء كافة ردود النداء الموجودة في القائمة عن طريق السياق (context) والوسطاء المُعطاة.
callbacks.fireWith( [context ] [, args ] )
أضيفت في الإصدار: 1.7.
context
أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل مرجعًا إلى السّياق (context) والذي في إطاره يجب أن تُطلَق ردود النداء الموجودة في القائمة.
args
كائن مشابه للمصفوفات (ArrayLikeObject)، ويُمثِّل مصفوفة أو كائن مشابه للمصفوفات الذي سيُمرَّر إلى ردود النداء الموجودة في القائمة. إن لم يُعرَّف فلن تُمرَّر أي وسطاء للتابع.
يُعيد هذا التابع كائن ردود النداء المُرفَق إليه (this
).
أمثلة
استخدام callbacks.fireWith()
لإطلاق قائمة من ردود النداء مع سياق مُحدَّد ومصفوفة من الوسطاء:
// دالة تسجيل بسيطة تُضاف إلى قائمة ردود النداء
var log = function( value1, value2 ) {
console.log( "Received: " + value1 + "," + value2 );
};
var callbacks = $.Callbacks();
// إضافة تابع التسجيل إلى قائمة ردود النداء
callbacks.add( log );
// إطلاق ردود النداء في القائمة باستخدام سياق النافذة ومصفوفة من الوسطاء
callbacks.fireWith( window, [ "foo","bar" ] );
// ينتج عنه "Received: foo, bar"