التابع ‎‎jQuery.holdReady()‎‎ في jQuery

من موسوعة حسوب
< jQuery‏ | 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 );
});

مصادر