تابع رد النداء ‎‎callbacks.lock()‎‎‎‎‎ في jQuery

تابع رد النداء ‎callbacks.lock()‎

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

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

الوصف

يُستخدَم تابع رد النداء ‎callbacks.lock()‎ في قفل قائمة ردود النداء بوضعها الحالي.

‎callbacks.lock()‎

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

لا يقبل هذا التّابع أي وسطاء.

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

إن كان كائن ردود النداء (Callbacks object) قد أُنشِئ عن طريق العَلَم memory كوسيط له، فيُمكِن إضافة وإطلاق دوال إضافيّة بعد قفل قائمة ردود النداء.

أمثلة

استخدام ‎callbacks.lock()‎ في قفل قائمة ردود النداء لتجنّب حدوث تغيّرات أخرى لحالة القائمة:

// دالة تسجيل بسيطة تُضاف إلى قائمة ردود النداء
var foo = function( value ) {
  console.log( "foo:" + value );
};
 
var callbacks = $.Callbacks();
 
// إضافة دالة التسجيل إلى قائمة ردود النداء
callbacks.add( foo );
 
// إطلاق العناصر الموجودة في القائمة عن طريق تمرير اسمها كوسيط
callbacks.fire( "hello" );
// ينتج عنه "foo: hello"
 
// قفل قائمة ردود النداء
callbacks.lock();
 
// محاولة إطلاق العناصر مرة أخرى
callbacks.fire( "world" );
 
// بما أنّ القائمة مقفولة فلن تُستدعى العناصر 
// وبالتالي لن تُعرَض رسالة السجل "foo: world"

استخدام ‎callbacks.lock()‎ في قفل قائمة ردود النداء مع استخدام العَلَم memory، ومن ثمّ متابعة استخدام القائمة: