التابع jQuery.holdReady() في jQuery
jQuery.holdReady( hold )
القيم المعادة
يعيد القيمة undefined.
الوصف
يعلِّق هذا التابع تنفيذ الحدث ready في jQuery أو يحرِّره إن كان معلَّقًا.
jQuery.holdReady( hold )
أُضيفت مع الإصدار: 1.6.
hold
قيمةٌ منطقيَّةٌ (Boolean) تحدِّد إن كان يراد تعليق تنفيذ الحدث ready أم إطلاقه للعمل بعد أن كان معلقًا.
يعمل التابع $.holdReady() على تأجيل تنفيذ استدعاء الحدث ready. سيستخدم هذه الميِّزة المتطورة عادةً محمِّلات السكربت الديناميكيَّة (dynamic script loaders) التي تريد تحميل شيفرة JavaScript إضافيَّة -مثل إضافات jQuery- قبل السماح للحدث ready بالوقوع حتى لو كانت DOM جاهزة. يجب أن يستدعى هذا التابع مبكرًا في المستند مثل أن يستدعى في <head> مباشرةً بعد الوسم <script> الذي يخص jQuery. لن يكون لاستدعاء هذا التابع بعد وقوع الحدث ready أي تأثير.
لتأخير وقوع الحدث ready، استدعِ أولًا $.holdReady( true )؛ وعندما يجب أن يُحرَّر هذا الحدث لتنفيذه، فاستدعِ $.holdReady( false ). انتبه إلى أنَّه يمكن تعليق الحدث ready أكثر من مرَّة واحدة باستدعاء $.holdReady( true ) مرات عديدة، ولا يطلق الحدث فعليًا حتى يحرَّر من جميع التعليقات التي طبِّقت عليه عبر استدعاء $.holdReady( false ) عددًا من المرات يساوي تلك التي طُلب فيها تعليق الحدث شرط أن تتوافر الشروط الأساسيَّة أيضًا لإطلاق الحدث ready.
أمثلة
تأجيل وقوع الحدث ready حتى يكتمل تحميل إضافة مخصَّصة:
$.holdReady( true );
$.getScript( "myplugin.js", function() {
$.holdReady( false );
});