الفرق بين المراجعتين ل"jQuery/callbacks/fireWith"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
سطر 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).

الوصف

يُستخدَم تابع رد النداء ‎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"

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=jQuery/callbacks/fireWith&oldid=8930"