الفرق بين المراجعتين ل"jQuery/callbacks/lock"
اذهب إلى التنقل
اذهب إلى البحث
تابع رد النداء
Kinan-mawed (نقاش | مساهمات) (أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:تابع رد النداء <code>callbacks.lock()</code> في jQuery}}</noinclude>') |
Kinan-mawed (نقاش | مساهمات) |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:تابع رد النداء <code>callbacks.lock()</code> في jQuery}}</noinclude> | <noinclude>{{DISPLAYTITLE:تابع رد النداء <code>callbacks.lock()</code> في jQuery}}</noinclude> | ||
+ | |||
+ | == تابع رد النداء <code>callbacks.lock()</code> == | ||
+ | |||
+ | ===القيمة المعادة=== | ||
+ | [[JQuery/callbacks|ردود نداء (Callbacks)]]. | ||
+ | ===الوصف=== | ||
+ | يُستخدَم تابع رد النداء <code>callbacks.lock()</code> في قفل قائمة ردود النداء بوضعها الحالي. | ||
+ | |||
+ | === <code>callbacks.lock()</code> === | ||
+ | أضيفت في الإصدار: 1.7. | ||
+ | |||
+ | لا يقبل هذا التّابع أي وسطاء. | ||
+ | |||
+ | يُعيد هذا التابع كائن ردود النداء المُرفَق إليه (<code>[[JavaScript/this|this]]</code>). | ||
+ | |||
+ | إن كان كائن ردود النداء (Callbacks object) قد أُنشِئ عن طريق العَلَم <code>memory</code> كوسيط له، فيُمكِن إضافة وإطلاق دوال إضافيّة بعد قفل قائمة ردود النداء. | ||
+ | |||
+ | === أمثلة === | ||
+ | استخدام <code>callbacks.lock()</code> في قفل قائمة ردود النداء لتجنّب حدوث تغيّرات أخرى لحالة القائمة:<syntaxhighlight lang="javascript"> | ||
+ | // دالة تسجيل بسيطة تُضاف إلى قائمة ردود النداء | ||
+ | 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" | ||
+ | </syntaxhighlight>استخدام <code>callbacks.lock()</code> في قفل قائمة ردود النداء مع استخدام العَلَم <code>memory</code>، ومن ثمّ متابعة استخدام القائمة: |
مراجعة 09:38، 22 مايو 2018
تابع رد النداء callbacks.lock()
القيمة المعادة
الوصف
يُستخدَم تابع رد النداء 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
، ومن ثمّ متابعة استخدام القائمة: