التابع .unload() في jQuery
.unload( handler )
القيمة المعادة
يُعيد كائنًا من النوع jQuery.
اٌُهمل مع الإصدار: 1.8, اُُزيل مع الإصدار: 3.0.
الوصف
ربط أحد معالجات الأحداث بحدث unload في JavaScript.
.unload( handler )
أُضيف مع الإصدار: 1.0.
handler
دالة تُنفَّذ عند تشغيل الحدث، وهي على الشكل Function( Event eventObject ).
.unload( [eventData ], handler )
أُضيف مع الإصدار: 1.4.3.
eventData
كائن عادي من البيانات التي ستمرر إلى معالج الحدث وقد يكون من أي نوع من الأنواع.
handler
دالة تُنفَّذ عند تشغيل الحدث، وهي على الشكل 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() هو مجرد اختصار للتابع .on( "unload", handler )، فإن إلغاء عمله ممكن باستخدام التابع.off( "unload" ).
أمثلة
عرض تنبيه عند إلغاء تحميل صفحة:
$( window ).unload(function() {
return "إلى اللقاء!";
});