الفرق بين المراجعتين لصفحة: «jQuery/callbacks/fireWith»

من موسوعة حسوب
لا ملخص تعديل
لا ملخص تعديل
سطر 4: سطر 4:
[[JQuery/callbacks|ردود نداء (Callbacks)]].
[[JQuery/callbacks|ردود نداء (Callbacks)]].
===الوصف===
===الوصف===
يُستخدَم تابع رد النداء ‎<code>callbacks.fireWith()</code>‎ في استدعاء كافة ردود النداء الموجودة في القائمة عن طريق السياق (context) والوسطاء المُعطاة.
يُستخدَم تابع رد النداء ‎<code>callbacks.fireWith()</code>‎ في استدعاء كافة ردود النداء الموجودة في القائمة عن طريق السياق (context) والوسائط المُعطاة.


=== <code>‎callbacks.fireWith( [context ] [, args ] )‎</code> ===
=== <code>‎callbacks.fireWith( [context ] [, args ] )‎</code> ===
سطر 13: سطر 13:


==== <code>args</code> ====
==== <code>args</code> ====
كائن مشابه للمصفوفات [[JavaScript/ArrayLikeObject|(ArrayLikeObject)]]، ويُمثِّل مصفوفة أو كائن مشابه للمصفوفات الذي سيُمرَّر إلى ردود النداء الموجودة في القائمة. إن لم يُعرَّف فلن تُمرَّر أي وسطاء للتابع.
كائن مشابه للمصفوفات (Array Like Object)، ويُمثِّل مصفوفة أو كائن مشابه للمصفوفات الذي سيُمرَّر إلى ردود النداء الموجودة في القائمة. إن لم يُعرَّف فلن تُمرَّر أي وسائط للتابع.


يُعيد هذا التابع كائن ردود النداء المُرفَق إليه (<code>[[JavaScript/this|this]]</code>).
يُعيد هذا التابع كائن ردود النداء المُرفَق إليه (<code>[[JavaScript/this|this]]</code>).


=== أمثلة ===
=== أمثلة ===
استخدام <code>‎callbacks.fireWith()</code>‎ لإطلاق قائمة من ردود النداء مع سياق مُحدَّد ومصفوفة من الوسطاء:<syntaxhighlight lang="javascript">
استخدام <code>‎callbacks.fireWith()</code>‎ لإطلاق قائمة من ردود النداء مع سياق مُحدَّد ومصفوفة من الوسائط:<syntaxhighlight lang="javascript">
// دالة تسجيل بسيطة تُضاف إلى قائمة ردود النداء
// دالة تسجيل بسيطة تُضاف إلى قائمة ردود النداء
var log = function( value1, value2 ) {
var log = function( value1, value2 ) {

مراجعة 13:49، 22 مايو 2018

 تابع رد النداء ‎callbacks.fireWith( [context ] [, args ] )‎‎

القيمة المعادة

ردود نداء (Callbacks).

الوصف

يُستخدَم تابع رد النداء ‎callbacks.fireWith()‎ في استدعاء كافة ردود النداء الموجودة في القائمة عن طريق السياق (context) والوسائط المُعطاة.

‎callbacks.fireWith( [context ] [, args ] )‎

أضيفت في الإصدار: 1.7.

context

أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل مرجعًا إلى السّياق (context) والذي في إطاره يجب أن تُطلَق ردود النداء الموجودة في القائمة.

args

كائن مشابه للمصفوفات (Array Like Object)، ويُمثِّل مصفوفة أو كائن مشابه للمصفوفات الذي سيُمرَّر إلى ردود النداء الموجودة في القائمة. إن لم يُعرَّف فلن تُمرَّر أي وسائط للتابع.

يُعيد هذا التابع كائن ردود النداء المُرفَق إليه (this).

أمثلة

استخدام ‎callbacks.fireWith()‎ لإطلاق قائمة من ردود النداء مع سياق مُحدَّد ومصفوفة من الوسائط:

// دالة تسجيل بسيطة تُضاف إلى قائمة ردود النداء
var log = function( value1, value2 ) {
  console.log( "استقبل: " + value1 + "," + value2 );
};
 
var callbacks = $.Callbacks();
 
// إضافة تابع التسجيل إلى قائمة ردود النداء
callbacks.add( log );
 
// إطلاق ردود النداء في القائمة باستخدام سياق النافذة ومصفوفة من الوسطاء
 
callbacks.fireWith( window, [ "foo","bar" ] );
// "استقبل: foo, bar" ينتج عنه

مصادر