jQuery 3.3

.unload()




jquery

.unload (معالج) الإرجاع: إصدار jQuery deprecated: 1.8 ، removed: 3.0

الوصف: ربط أحد معالجات الأحداث بحدث JavaScript "إلغاء تحميل".

  • الإصدار المضاف: 1.0 .unload (معالج)

    • معالج
      النوع: Function ( Event eventObject)
      دالة يتم تنفيذها عند تشغيل الحدث.
  • الإصدار المضاف: 1.4.3 .unload ([eventData] ، معالج)

    • eventData
      النوع: Anything
      كائن عادي من البيانات التي سيتم تمريرها إلى معالج الحدث.
    • معالج
      النوع: Function ( Event eventObject)
      هي وظيفة يتم تنفيذها في كل مرة يتم فيها تشغيل الحدث.

هذه الطريقة هي اختصار لـ .on( "unload", handler ) .

يتم إرسال حدث unload إلى عنصر window عندما يتنقل المستخدم بعيدًا عن الصفحة. هذا يمكن أن يعني واحد من العديد من الأشياء. كان بإمكان المستخدم النقر على رابط لمغادرة الصفحة أو كتابة عنوان URL جديد في شريط العنوان. سيؤدي الزران للأمام والخلف إلى تشغيل الحدث. سيؤدي إغلاق نافذة المتصفح إلى تشغيل الحدث. حتى إعادة تحميل الصفحة ستقوم أولاً بإنشاء حدث unload .

تباينت المعالجة الدقيقة لحدث unload من إصدار إلى إصدار من المتصفحات. على سبيل المثال ، تقوم بعض إصدارات Firefox بتشغيل الحدث عند اتباع الارتباط ، ولكن ليس عند إغلاق النافذة. في الاستخدام العملي ، يجب اختبار السلوك على جميع المتصفحات المدعومة ويتناقض مع حدث beforeunload المماثل.

يجب أن يرتبط أي معالج أحداث unload الكائن window :

$( window ).unload(function() {
  return "Handler for .unload() called.";
});

يتوفر هذا الحدث بحيث يمكن تنفيذ البرامج النصية عند مغادرة المستخدم للصفحة. ستتجاهل معظم المتصفحات المكالمات alert() confirm() و prompt() داخل معالج الأحداث. قد يتم استخدام السلسلة التي تقوم بإرجاعها في مربع حوار تأكيد ، ولكن لا تدعم كافة المستعرضات هذا. لا يمكن إلغاء الحدث unload مع .preventDefault() .

ملاحظات إضافية:

  • نظرًا .unload() طريقة .unload() هي مجرد اختصار لـ .on( "unload", handler ) ، فإن .off( "unload" ) ممكن باستخدام .off( "unload" ) .

مثال:

لعرض تنبيه عند إلغاء تحميل صفحة:

$( window ).unload(function() {
  return "Bye now!";
});