الفرق بين المراجعتين لصفحة: «jQuery/unload»
Khaled-yassin (نقاش | مساهمات) أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>.unload()</code> في jQu...' |
ط استبدال النص - 'jQuery/preventDefault' ب'jQuery/event/preventDefault' |
||
| (2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 8: | سطر 8: | ||
=== الوصف === | === الوصف === | ||
ربط أحد معالجات الأحداث بحدث | ربط أحد معالجات الأحداث بحدث <code>unload</code> في [[JavaScript]]. | ||
=== <code>.unload( handler )</code> === | === <code>.unload( handler )</code> === | ||
| سطر 14: | سطر 14: | ||
==== <code>handler</code> ==== | ==== <code>handler</code> ==== | ||
دالة تُنفَّذ عند تشغيل الحدث، وهي على الشكل [[JavaScript/Function|Function]]( Event eventObject ). | دالة تُنفَّذ عند تشغيل الحدث، وهي على الشكل <code>[[JavaScript/Function|Function]]( Event eventObject )</code>. | ||
=== <code>.unload( [eventData ], handler )</code> === | === <code>.unload( [eventData ], handler )</code> === | ||
| سطر 23: | سطر 23: | ||
==== <code>handler</code> ==== | ==== <code>handler</code> ==== | ||
دالة تُنفَّذ عند تشغيل الحدث، وهي على الشكل [[JavaScript/Function|Function]]( Event eventObject ). | دالة تُنفَّذ عند تشغيل الحدث، وهي على الشكل <code>[[JavaScript/Function|Function]]( Event eventObject )</code>. | ||
يُعد هذا التابع اختصارًا للتابع [[jQuery/on|.on( "unload", handler )]]. | يُعد هذا التابع اختصارًا للتابع [[jQuery/on|<code>.on( "unload", handler )</code>]]. | ||
يُرسل الحدث <code>unload</code> إلى العنصر <code>window</code> عندما يتنقل المستخدم بعيدًا عن الصفحة. قد يعني هذا شيئًا واحدًا من العديد من الأشياء. قد يكون نقر المستخدم على رابط لمغادرة الصفحة أو كتابة عنوان URL جديد في شريط العناوين. وقد يكون الضغط على أحد الزران للأمام أو للخلف. وقد يكون إغلاق نافذة المتصفح. وحتى إعادة تحميل الصفحة يُنشئ الحدث <code>unload</code>. | يُرسل الحدث <code>unload</code> إلى العنصر <code>window</code> عندما يتنقل المستخدم بعيدًا عن الصفحة. قد يعني هذا شيئًا واحدًا من العديد من الأشياء. قد يكون نقر المستخدم على رابط لمغادرة الصفحة أو كتابة عنوان URL جديد في شريط العناوين. وقد يكون الضغط على أحد الزران للأمام أو للخلف. وقد يكون إغلاق نافذة المتصفح. وحتى إعادة تحميل الصفحة يُنشئ الحدث <code>unload</code>. | ||
| سطر 35: | سطر 35: | ||
return "Handler for .unload() called."; | return "Handler for .unload() called."; | ||
}); | }); | ||
</syntaxhighlight>يوجد هذا الحدث بحيث يمكن تنفيذ | </syntaxhighlight>يوجد هذا الحدث بحيث يمكن تنفيذ سكربت عند مغادرة المستخدم للصفحة. ستتجاهل معظم المتصفحات الاستدعاءات <code>alert()</code> و <code>confirm()</code> و <code>prompt()</code> داخل معالج الأحداث. قد تستخدم السلسلة النصية التي تُعيدها في نافذة حوار للتأكيد، ولكن لا تدعم كافة المتصفحات ذلك. لا يمكن إلغاء الحدث <code>unload</code> مع <code>[[jQuery/event/preventDefault|.preventDefault()]]</code>. | ||
=== ملاحظات إضافية === | === ملاحظات إضافية === | ||
| سطر 41: | سطر 41: | ||
=== أمثلة === | === أمثلة === | ||
عرض تنبيه عند إلغاء تحميل صفحة | عرض تنبيه عند إلغاء تحميل صفحة:<syntaxhighlight lang="jquery"> | ||
$( window ).unload(function() { | $( window ).unload(function() { | ||
return "إلى اللقاء!"; | return "إلى اللقاء!"; | ||
المراجعة الحالية بتاريخ 11:03، 1 يوليو 2018
.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 "إلى اللقاء!";
});