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

‎.contextmenu( handler )‎

القيمة المعادة

كائن jQuery.

الوصف

يُستخدَم التابع ‎‎.contextmenu()‎‎ في ربط مُعالِج أحداث (event handler) إلى الحدث ‎contextmenu‎ في JavaScript، أو إطلاق هذا الحدث على عنصر ما.

‎.contextmenu( handler )‎

أضيفت في الإصدار: 1.0.

handler

دالة على الشكل ‎Function( Event eventObject )‎، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُطلَق فيها الحدث.

‎.contextmenu( [eventData ], handler )‎

أضيفت في الإصدار: 1.4.3.

eventData

أي شيء (وهو نوع افتراضي مُستخدَم في jQuery للإشارة إلى إمكانيّة استخدام أي نوع)، ويُمثِّل كائن يحتوي على البيانات التي ستُمرَّر إلى مُعالِج الأحداث.

handler

دالة على الشكل ‎Function( Event eventObject )‎، وتُمثِّل الدالة التي ستُنفَّذ في كل مرة يُطلَق فيها الحدث.

‎.contextmenu()‎

أضيفت في الإصدار: 1.0.

لا يقبل هذا الشكل من التّابع أيّة وسائط.

يُعدُّ هذا التّابع اختصارًا للتابع ‎.on( "contextmenu", handler )‎ في أول شكلين له، وللتّابع ‎.trigger( "contextmenu" )‎ في شكله الثّالث. يُرسَل الحدث contextmenu إلى العنصر عند النقر على زر الفأرة الأيمن، ولكن قبل ظهور القائمة المنبثقة (context menu)، وهي القائمة التي تظهر عند نقر المستخدم على زر الفأرة الأيمن.